1、 浙江省公共数据开放技术规范目 录1.数据开放分界面规范61.1范围61.2界面与内容设计原则61.3基础元素61.3.1颜色61.3.2字体71.3.3尺寸71.4通用区域71.4.1概述71.4.2页头81.4.3页尾81.5页面布局91.5.1概述91.5.2主体内容区92.开放数据标准规范92.1开放数据领域分类标准92.2数据集格式标准92.3数据集存储元数据标准102.4数据集展示元数据标准152.5API接口展示元数据标准152.6API接口描述标准162.7应用成果展示元数据规范173.域名及用户对接规范183.1域名使用规范183.2用户对接规范184.省数据开放网站前台功能
2、194.1概述194.2数据开放栏目设置194.3数据开放194.3.1数据集列表194.3.2数据集详细页204.3.3数据目录204.3.4可视化与分析工具214.4接口服务214.4.1接口列表页214.4.2接口详细页214.5应用成果224.5.1应用成果列表页224.5.2应用成果详细页224.5.3成果提交234.6地图服务234.7开发者中心234.8开放指数234.9互动交流244.9.1数据集评价功能244.9.2数据请求功能244.9.3建议反馈功能244.9.4数据纠错功能244.9.5分享传播功能244.9.6社交媒体账号开设254.10政策动态254.11用户使用相
3、关流程254.11.1用户注册流程254.11.2接口申请流程264.11.3数据申请流程274.11.4应用上架流程275.省统一数据开放平台功能介绍285.1概述285.2平台概况285.3平台管理295.3.1站点管理295.3.2元数据管理295.3.3用户使用协议305.3.4日志记录305.3.5开放目录管理315.3.6开放目录导入315.3.7开放目录审核315.3.8开放目录发布315.3.9开放目录生成同步脚本325.3.10开放目录开放等级配置325.3.11数据集管理325.3.12数据集审核335.3.13数据集数据预览335.3.14数据集协议配置335.3.15数
4、据集生成335.3.16数据文件下载审核335.3.17接口管理335.3.18接口配置345.3.19接口申请审核345.3.20应用成果345.3.21应用成果提交审核355.4互动评论355.4.1评论、评分审核355.4.2纠错审核355.5统计分析365.5.1数据审核统计365.5.2下载次数统计365.5.3接口申请统计365.5.4接口调用统计365.5.5部门开放统计365.5.6领域开放统计365.5.7未及时更新统计375.5.8下载访问统计375.5.9数据更新统计371. 数据开放界面规范1.1 范围 本标准规定了数据开放平台界面与内容规范要求，对数据开放平台与内容的
5、设计原则、基础元素、通用区域、首页以及栏目等内容进行了规范。本标准适用浙江省各级数据开放平台界面与内容的设计、开发。1.2 界面与内容设计原则 数据开放平台界面与内容设计，应遵循以下设计原则： a) 页面整体设计风格应一致，页面布局和用图、用色风格前后一致；b) 相同功能的元素规范应一致；c) 不同栏目版块内容不宜有交叉重复内容，共性较多的内容应尽量划分到同一栏目版块；d) 结构层次不宜超过3层；e) 常用信息内容、功能服务宜放到较浅层次；f) 信息内容获取和功能服务过程不宜超过 3步，当需要更多步骤时应有明确提示。1.3 基础元素 1.3.1 颜色 数据开放平台所有页面风格应选用主流色彩风格
6、，第一时间带给访问者信任感与权威感。1.3.2 字体 数据开放平台界面与内容的常规字体应满足以下规范： a）中文字体应采用微软雅黑，字号不宜超过17px； b）合理设置页面行间距； c）应避免大面积使用加粗、加下划线和倾斜字体； d）标点符号宜采用中文格式半角； e）英文和数字宜采用Arial字体。 1.3.3 尺寸 数据开放平台界面与内容的尺寸应满足以下规范：a) 数据开放平台界面所有页面最大宽度尺寸 1366px； b) 内页分栏应按照统一规格设计，分两栏； c) 两栏的页面设计横向比例规范：210px:1016px； d) 当通过不同终端访问数据开放平台时，界面应能自适应的调整分辨率，以
7、适应不同终端的不同显示效果的需要。1.4 通用区域 1.4.1 概述页头位于数据开放平台页面的顶部，各页面均应展示页头部分，页头由数据开放平台标识、导航区组成。 1.4.1.1. 数据开放平台标识 数据开放平台标识应满足以下规范：a) 中文名称为“*数据开放平台”；b) 字体为微软雅黑体；1.4.2 页头1.4.2.1. 导航区 导航区栏目应包括首页、开放数据、接口服务、应用成果、地图服务、开发者中心、开放指数、互动交流、政策动态、数据检索、注册、服务条款、快速登录等。1.4.3 页尾 数据开放平台页尾应满足以下规范： a) 页尾区提供网站地图、联系我们、网站声明、使用手册；b) 主办单位名称
8、为主办单位全称；c) 版权申明内容为主办单位版权所有；d) ICP备案内容为浙ICP备*号。f) 公网安备内容为浙公网安备*号j) 具有“建议使用1366*768分辨率/IE9.0或以上浏览器访问达到最佳效果”提示。1.5 页面布局 1.5.1 概述 数据开放平台各级页面由页头区、主体内容区、页尾区三部分组成。页头区按5.1节给出的要求，页 尾区按5.2节给出的要求。 1.5.2 主体内容区 主体内容区的栏目设置，宜依据实际业务需要自由设计。主体内容区的颜色、常规字体、尺寸规范 分别按4.1、4.2、4.3节给出的要求。2. 开放数据标准规范2.1 开放数据领域分类标准数据开放平台领域分类应不
9、少于21各分类：安全生产、教育文化、科技创新、气象服务、商贸流通、社保就业、社会救助、生活服务、生态环境、市场监督、财税金融、信用服务、医疗卫生、资源能源、城建住房、地理空间、法律服务、工业农业、公共安全、机构团体、交通运输。各设市区可以基于以上分类自行扩展个性化领域分类，同时鼓励各设区市开展场景分类，将数据集进行场景化展示，例如：升学、培训考试、设立变更、申请专利等。2.2 数据集格式标准数据开放平台应该提供至少5种数据格式，分别为：XLS、CSV、XML、JSON、RDF。注：RDF格式（资源描述框架）作为W3C的推荐标准，使用了“主体谓词客体”三元组形式来描述数据资源和它们之 间的关系，
10、使数据资源更易于被机器阅读和理解，有助于数据利用者发现和链接相关数据资源。附：开放数据的格式标准，万维网发明者Tim BernersLee提出了开放数据的五星标准一星：基于开放授权在网络 上开放数据，对数据格式不做要求，可能采用PDF、JPEG等格式； 二星：以可机读、结构化格式开放数据（如采用EXCEL格式而 非扫描格式）；三星：在满足二星标准的基础上，以非专属开放格式开放数据（如采用CSV格式代替EXCEL格式）；四星： 在满足以上要求的基础上，采用万维网联盟（W3C）的开放标 准（如RDF和SPARQL）来识别数据集中的事物或主体，每个事物采用统一资源标识符（URI）来进行标识；五星：在
11、满足以 上要求的基础上，数据集提供更多的与其他数据集数据之间的关联链接，以便使用者在使用数据的同时发现更多的相关信息。2.3 数据集存储元数据标准元数据说明1.数源单位定 义：提供政务信息资源的政务部门。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：具体提供信息资源的部门和单位，原则上细化到内设机构和所辖政务部门。2.信息资源名称定 义：缩略描述政务信息资源内容的标题。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：缩略描述对应政务信息资源具体内容的标题。3.信息资源代码定 义：政务信息资源的唯一不变的标识代码。数据类型：字符型。注 解：必选项；最大出现次数为 1
12、。说 明：信息资源代码规则详见说明。4.信息资源摘要定 义：对信息资源内容（或关键字段）的概要描述。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：对资源内容进行概要说明（或关键字段）的描述。5.信息资源格式定 义：信息资源的存在方式（可多选）。信息资源提供方应尽可能提供可机读的电子格式及相关软件版本信息，如只有纸质介质，应尽量提供电子扫描格式。电子格式的信息资源，可采用但不限于：电子文件的存储格式为 OFD、wps、 xml、txt、 doc、 docx、 html、 pdf、 ppt 等； 电子表格的存储格式为 et、 xls、 xlsx 等；数据库类的存储格式为 Dm、 K
13、ingbaseES、access、 dbf、 dbase、 sysbase、oracle、 sql server、 db2 等，同时需明确具体的数据库表结构定义（可细化至“信息项信息”元数据中）；图形图像类的存储格式为 jpg、 gif、 bmp 等；流媒体类的存储格式为 swf、 rm、 mpg 等；自描述格式，由提供方提出其特殊行业领域的通用格式，如气象部门采用的“表格驱动码”格式。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：按定义的多种格式选择确定。6.标签定义：对信息资源内容进行关键字概要提取。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：对信息资源内
14、容进行关键字段提取的描述。7.数据领域定义：对信息资源内容进行主题领域划分。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：对信息资源内容进行主题领域划分描述。8.行业分类定义：对信息资源所在主题领域的所属行业分类。数据类型：字符型。注 解：必选项；最大出现次数为 1。说明：对信息资源所在主题领域的所属行业进行分类。9.更新频率定 义：信息资源更新的频度。分为实时、每日、每周、每月、每季度、每年等。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：属于结构化数据资源的，按更新频度较快的信息项进行描述；属于非结构化数据资源的，则对信息资源整体进行描述。10.数据容量定义
15、：信息资源中完全开放的字段数与数据条数的乘积。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：按定义要求进行描述。11.所属行政区域定义：说明该信息资源内容提供方所在的行政区域。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：按定义要求进行描述。12.发布日期定 义：政务信息资源提供方发布共享、开放政务信息资源的日期。数据类型：日期型，格式为 CCYY-MM-DD。注 解：必选项；最大出现次数为 1。说 明：按定义要求进行描述。13.信息项中文名称定 义：描述结构化信息资源中具体数据项的标题。适用于格式为数据库、电子表格类等的信息资源。数据类型：字符型。注 解：可选
16、项；最大出现次数为 1。说 明：描述电子表格、数据库，以及具有结构化数据内容资源中的各数据项（字段）标题，采用中文表示。14.信息项英文名称定 义：信息项的英文名。数据类型：字符型。注 解：可选项；最大出现次数为 1。说 明：描述信息项的英文名。15.字段描述定 义：描述信息项表字段的具体文字说明。数据类型：字符型。注 解：可选项；最大出现次数为 1。说 明：描述信息项的表字段描述信息。16.数据类型定 义：标明该信息项的数据类型。其中，属于文本类信息的，应标明所采用的字符集和编码方式，推荐使用GB13000-2010 及其后续版本字符集和 UTF-8 或 UTF-16方式编码；属于结构化数据
17、的，应标明数据类型及数据长度，包括：字符型 C、 数值型 N、 货币型 Y、 日期型D、 日期时间型 T、逻辑型 L、 备注型 M、 通用型 G、双精度型 B、 整型 I、 浮点型 F 等。数据类型：字符型。注 解：必选项；最大出现次数为 1。说 明：对应“信息项名称”逐一描述其数据类型。17.是否向社会开放定 义：信息资源面向社会开放的属性，包括“是”和“否”，对应取值分别为 1 和 0。数据类型：字符型。注 解：可选项；最大出现次数为 1。说 明：按定义要求进行描述。18.开放条件定义：对向社会开放资源的条件描述。当“是否向社会开放”取值为1时，描述开放条件。数据类型：字符型。注 解：可选
18、项；最大出现次数为 1。说 明：按定义要求进行描述。19.是否字典项定 义：该信息项是否有字典项，如是，则可以选择字典表或填写备注。数据类型：字符型。注 解：可选项；最大出现次数为 1。说 明：按定义要求进行描述。20.是否主键定 义：该信息项是否为数据表的主键，包括“是”和“否”，对应取值分别为 1 和 0。数据类型：字符型。注 解：可选项； 最大出现次数为 1。说 明：按定义要求进行描述。21.是否为空定 义：该信息项是否为数据表的主键，包括“是”和“否”，对应取值分别为 1 和 0。数据类型：字符型。注 解：可选项； 最大出现次数为 1。说 明：按定义要求进行描述。说明：信息资源代码编码
19、规则（1）信息资源“类”，即信息资源的一级分类，用1位阿拉伯数字表示。根据政务信息资源目录的资源属性分类规定的分类方法， “1”代表基础信息资源类，“2”代表主题信息资源类，“3”代表部门信息资源类。（2）信息资源“项”，即信息资源的二级分类，共2位，原则上用阿拉伯数字表示。如，基础信息资源类中的人口、法人信息资源等分类；主题信息资源类中的公共服务、全民健康、全民社保等分类；部门信息资源类中的省委政法委（省综治委）、省编办、省信访局等分类。（3）信息资源“目”，即信息资源的三级分类，共3位，原则上用阿拉伯数字表示。（4）信息资源“细目”，不定长度，原则上用阿拉伯数字表示，供信息资源提供方进行具
20、体的信息资源分类。“细目”可根据需要设置多级分类。2.4 数据集展示元数据标准每个数据集的描述元数据应不低于21项：具体如下：信息资源名称、信息资源摘要、资源代码、标签、更新周期、资源格式、数源单位、数源单位地址、访问下载次数、数据领域、业务系统名称、评分评价次数、行业分类、数据预览、数据等级、开放条件、数据范围、更新日期、发布日期、数据量、数据图谱。2.5 API接口展示元数据标准每个API接口元数据描述应不低于9项，具体如下：信息资源名称、信息资源摘要、数据领域、更新周期、资源格式、数源单位、数源单位地址、访问次数、数据预览。2.6 API接口描述标准数据开放平台提供的API接口应有明确的
21、接口描述、接口地址、支持格式、请求方式、请求参数、请求样例、返回参数、返回样例等说明。每个数据集需要提供获取总量接口、分页接口两个接口类型，方便使用者获取全量和增量数据。以下为省数据开放网站接口说明供参照：（一）获取数据总量接口接口地址http:/域名/jdop_front/interfaces/cata_数字/get_total.do支持格式JSON请求方式GET/POST接口描述获取数据总数请求样例/jdop_front/interfaces/cata_5535/get_total.do?appsecret=5a558b60a9384771a393287f051cd6c0请求参数appse
22、cret：注册用户接口申请通过后的校验码返回样例status:1,msg:成功,data:200返回参数说明status：0代表失败，1代表成功msg：返回信息data：返回个数（二）分页获取数据详细接口接口地址http:/域名/jdop_front/interfaces/cata_数字/get_data.do支持格式JSON请求方式GET/POST接口描述分页获取数据详细请求样例/jdop_front/interfaces/cata_5535/get_data.do?pageNum=1&pageSize=1&appsecret=5a558b60a9384771a393287f051cd6c0
23、请求参数appsecret：注册用户接口申请通过后的校验码pageNum：页码pageSize：每页个数（不超过200）返回样例status:1,msg:成功,data:iid:1,filepath:E:/APP,fileserverurl:http:/192.168.89.58:80,searchday:7,searchper:1,searchtimes:1,searchurl:http:/127.0.0.1:8080/searchserver_local,searchdb:jdop1_1返回参数说明status：0代表失败，1代表成功msg：返回信息data：信息的详细属性2.7 应用成果
24、展示元数据规范应用成果提交应分为4类，分别是：服务应用、传播产品、创新方案和研究成果。（1）服务应用，即企事业单位利用开放数据开发的各种 服务应用，如：APP应用、小程序应用或网站应用。服务应用元数据应不低于9项：具体为：应用名称、标签、领域分类、开发团队、数据集名称、图片、描述、应用访问地址、应用详情。（2）传播产品，即将开放数据经过分析或可视化处理后，以公众易于 理解的数据新闻、自媒体文章等形式向社会传播。传播产品元数据应不低于8项：具体为：标题、领域分类、开发团队、图片、附件、视频地址、访问地址、描述。（3）研究成果，即高校、研究机构、社会团体等主体利用开放数据产生 的研究报告、学术论文
25、等成果。创新方案元数据应不低于6项：具体为：标题、领域分类、开发团队、图片、附件、描述。（4）创新方案，即各地开放数据创新利用比赛中参赛者产生的创新方案。研究成果元数据应不低于6项：具体为：标题、领域分类、开发团队、图片、附件、描述。3. 域名及用户对接规范3.1 域名使用规范省数据开放网站域名为：，各设区市域名应采用省数据开放网站域名的二级域名来访问。二级域名的组成方式为：“地区简称”+“。各地区简称如下：部门名称域名简称部门名称域名简称省级zj杭州hz宁波nb温州wz嘉兴jx湖州huz绍兴sx金华jh衢州qz舟山zs台州taz丽水lis3.2 用户对接规范各设区市数据开放用户需要和浙江政务
26、服务网统一用户进行整合，政务服务网注册的用户不用二次登录可以直接使用各平台的开放数据。4. 省数据开放网站前台功能4.1 概述主要描述省数据开放网站的相关功能，各设区市子网的功能应包括但不限于文档描述的相关功能。4.2 数据开放栏目设置数据开放平台设置的一级栏目包含但不限于以下六项：数据集、接口服务、应用成果、开发者中心、开放指数、互动交流。省数据开放网站栏目概况示意图见图1。图4-1 栏目概况示意图4.3 数据开放4.3.1 数据集列表数据集是由数据组成的集合，在数据开放平台中，能够从数据提供机构、领域分类、格式分类对数据集进行分类筛选的展现。能够通过数据集名称关键词进行检索，能够按照访问量
27、、更新时间、下载量、数据容量、数据评分等维度进行排序。数据集的前台访问以列表形式进行展现，在列表页展现数据集的摘要信息，包括：数据集名称、评分、简介、数据容量、本数据集支持的格式、提供者、所属领域、查看次数、下载次数、更新时间等，具有收藏和数据预览的快速入口。4.3.2 数据集详细页各数据集详细页提供数据集详情展示与申请等操作功能，数据集元数据格式规范详见：第二章数据集展示元数据标准。提供数据集的收藏、订阅、纠错功能。提供数据集预览和可视化入口。提供数据集API调用入口。提供数据集数据图谱展示入口。提供数据集下载和历史数据下载入口。提供当前数据集内数据项预览展示。提供当前数据集关联信息列表展示
28、。提供当前数据集的相关开发应用成果。提供对本数据集的评分和评论操作功能。4.3.3 数据目录平台应提供开放数据资源目录，帮助用户了解开放数据全貌。数据资源目录应能按照单位进行筛选显示，以列表形式展现，列表页主要展现数据资源名称、数据单位、目录发布时间、信息项摘要等。4.3.4 可视化与分析工具可视化与分析工具是指提供了实现数据集可视化或统计分析的工具。用户可以在数据集页面通过设置不同条件，对数据进行初步的统计分析，还可以对统计结果进行可视化呈现，如饼状图、柱状图和曲线图。4.4 接口服务4.4.1 接口列表页除直接下载数据以外，还应提供开放数据的应用程序编程接口（即API接口，Applicat
29、ion Programming Interface），与通过直接下载方式获取数据集相比，接口方式使用户可以通过参数实施高效的获取所需数据，满足开发应用程序的需要。在数据开放平台中，能够从数据提供机构和领域分类对数据集进行分类筛选的展现。能够通过接口名称关键词进行检索，能够按照访问量、更新时间、调用量、数据评分等维度进行排序。接口的前台访问以列表形式进行展现，在列表页展现接口的摘要信息，包括：数据接口名称、评分、简介、提供者、所属领域、查看次数、下载次数、更新时间、接口申请等。4.4.2 接口详细页各接口详细页提供接口详情展示与申请等操作功能，接口元数据格式规范详见：第二章API接口展示元数据标准。提供接口的收藏、纠错功能。提供总数接口、分页接口、分页返回接口调用方式描述。提供接口申请入口。提供对本接口的评分和评论操作功能。4.5 应用成果数据利用成果指的是数据开放平台向社会集中展现用户利用平台上开放的数据后产生的各类数
