B.C.'s Map Hub
Metadata and Presentation Guidelines for
Data, Maps and Apps
Date: July, 2016
Version: V 1.0
/ B.C.'s Map HubMetadata Guidelines for Data and Maps
TABLE OF CONTENTS
1 DOCUMENT PURPOSE 1
2 Feature or Map Service Layers Details Page 2
2.1 Overview 2
2.2 Content Requirements 2
3 WEB MAP Details Page 4
3.1 Overview 4
3.2 Content Requirements 4
4 WEB APPLICATION Details Page 6
4.1 Overview 6
4.2 Content Requirements 6
5 Branding Requirements 8
6 CONFIGURABLE Web APPS with POP-UPs 8
7 CONFIGURABLE Web APPS without POP-UPs 8
1 DOCUMENT PURPOSE
The purpose of this document is to provide the guidelines to include content in the Details page for data, maps and applications.
Note that the Details page content for a Web Map is slightly different than a Web App as the Web Map page automatically presents the layers used by the Map. For this reason, the content requirements for Data, Web Maps and Web Apps have been described separately. See "What is the difference between a map and a web app within the context of the website?" for general information about the differences.
2 Feature or Map Service Layers Details Page
2.1 Overview
When an item is created and is being saved for the first time, the user must enter content into the Title, Summary and Description and Tags (1 required). After the item has been saved this information can be revised, and additional information added, by editing the Details page for the item.
In order for the data to be published to "Public", it's security level must be "Publicly viewable".
Note that if:
· The data is available in the BC Geographic Warehouse (BCGW);
· There is a related MPCM Layer file; and
· There is a related metadata record registered in BC Data Catalogue;
the ArcGIS Online Details page will be created for you by a scheduled automated process.
Otherwise the data:
· Must be registered in BC Data Catalogue; and
· The ArcGIS Online Details page must be completed with content as described in Section 3.2.
2.2 Content Requirements
The following is required for hosted Feature Layers and Web Services that are components of the Map/App. For a Feature Layer, if there is a related Service Definition, the Service Definition content should be the same as the Feature Layer. The content in the Details Page should be the same as the corresponding field in the BCDC Record as identified below. Examples of where these guidelines have been applied include:
· Network Connectivity in BC-Feature Layer and Network Connectivity in BC-Service Definition
· BC Airports - Map Layer - REST Service - created by scheduled automated process as described above.
Item / Guideline / BCDC Record / Mandatory or Optional /Title / Should be short, easily distinguished/unique, and accurately describes the map / Title / Mandatory
Summary / Should be a subset of the Description (80 or so characters) with ... after. / n/a / Mandatory
Description / Should be a paragraph that describes the data. In addition to the Description from the BCDC record, also include the following:
BC Data Catalogue metadata: Clickable link for URL of the BCDC record using the Permalink, e.g.
For example:
BC Data Catalogue metadata: https://catalogue.data.gov.bc.ca/dataset/17d8b94d-0a67-46c3-b974-fc164ae1a855
To obtain the Permalink go to the BCDC Record, and click on the Permalink button above the Title, then copy the URL and past into the Details Page.
/ Description / Mandatory
Tags / British Columbia and Canada must be included as Tags.
Include Keywords from the BCDC Record and additional tags that help people search for the data. / Keywords are under Description / Mandatory
Credits / Include the Sub-Organization from the BCDC Record. This is found immediately below the Title. Elections BC is the Sub-Organization. in this example "Published by the BC Agency - Elections BC". / Sub-Organization / Mandatory
Access and Use Constraints: / Include the following content to describe Licensing and Copyright and Disclaimer:
· Link to Copyright is: http://www2.gov.bc.ca/gov/content/home/copyright
· Link to Disclaimer is: http://www2.gov.bc.ca/gov/content/governments/about-the-bc-government/databc/geographic-data-and-services/agol/access-and-use-constraints
· XXX - use "feature layer" or "web service" as applicable
· YYY - License or Copyright content as shown next to "Licensed under
For example: Licensed under Open Government License - British Columbia
Content:
The data provided by this XXX is licensed under YYY
This XXX isCopyright ©, Province of British Columbia. All rights reserved.
The B.C. Map Hub and associated materials, including map applications ("Maps"), trade-marks and official marks (collectively, "Materials"), are owned or used under license by the Province of British Columbia ("Province") and are protected by copyright and trade-mark laws. Please see the Disclaimer for further details.
The Province does not collect, use or disclose personal information through the ArcGIS Online website. Please be aware, however, that IP addresses are collected by Esri and are stored on Esri's servers located outside of Canada. For further information, including the purposes for which your IP address is collected, please see Esri's Privacy Policy at:http://www.esri.com/legal/privacy. By accessing or using the B.C. Map Hub, you consent, effective as of the date of such access or use, to Esri storing and accessing your IP address outside of Canada for the purposes described in Esri's Privacy Policy. Should you have any questions about the collection of your IP address, please contact BCGov AGOL CONTACT at , PO BOX 9864 STN PROV GOVT, Victoria BC V8W 9T5 / Licensed under / Mandatory
Thumbnail / Replace the default thumbnail for the gallery display with a photo or screenshot of the map. As per the Details Page Pop-up: "For best results, the image should be 200 pixels wide by 133 pixels high. Other sizes will be adjusted to fit. Acceptable image formats are: PNG, GIF and JPEG". If you'd like to add customize your image further, Here are links to the 'Thumbnail' generator software on GITHUB:
· https://github.com/Esri/thumbnail-builder-js
· http://nwdemo1.esri.com/thumbnailbuilder/ / Optional
3 WEB MAP Details Page
3.1 Overview
When any item is created and is being saved for the first time, the user must enter content into the Title, Summary and Description and Tags (1 required). After the item has been saved this information can be revised, and additional information added, by editing the Details page for the item.
3.2 Content Requirements
The following is required for all web maps that are published to Public.
The content in the Details Page should be the same as the corresponding field in the BCDC Record as identified below. Examples of where these guidelines have been applied include:
· NetworkBC Broadband Connectivity and Cellular Coverage Web Map - which includes hosted Feature Layers
· BC Stops of Interest Signs - Map - which includes data hosted from the BC Data Catalogue
Item / Guideline / BCDC Record / Mandatory or Optional /Title / Should be short, easily distinguished/unique, and accurately describes the map / Title / Mandatory
Summary / Should be a subset of the Description (80 or so characters) with ... after. / n/a / Mandatory
Description / Should be a paragraph that explains the map purpose.
In addition to the Description from the BCDC record, also include the following:
BC Data Catalogue metadata:
Map: Clickable link for URL of the BCDC record using the Permalink.
If the data accessed is being hosted on the BCDC, include the following:
Data: Clickable link for URL of the BCDC record using the Permalink.
For example:
BC Data Catalogue metadata:
Map: https://catalogue.data.gov.bc.ca/dataset/cfdfcf1e-c3c8-4475-b12f-05d3ec7ef2e0
Data: https://catalogue.data.gov.bc.ca/dataset/17d8b94d-0a67-46c3-b974-fc164ae1a855
To obtain the Permalink go to the BCDC Record, and click on the Permalink button above the Title, then copy the URL and past into the Details Page.
/ Description / Mandatory
Tags / British Columbia and Canada must be included as Tags.
Include Keywords from the BCDC Record and additional tags that help people search for your map/application. / Keywords located under Description / Mandatory
Credits / Include the Sub-Organization from the BCDC Record. This is found immediately below the Title. Elections BC is the Sub-Organization. in this example "Published by the BC Agency - Elections BC". / Sub-Organization / Mandatory
Access and Use Constraints: / Include the following content (blue text only).
· Link to Copyright is: http://www2.gov.bc.ca/gov/content/home/copyright
· Link to Disclaimer is: http://www2.gov.bc.ca/gov/content/governments/about-the-bc-government/databc/geographic-data-and-services/agol/access-and-use-constraints
Content:
This map is Copyright ©, Province of British Columbia. All rights reserved.
The B.C. Map Hub and associated materials, including map applications ("Maps"), trade-marks and official marks (collectively, "Materials"), are owned or used under license by the Province of British Columbia ("Province") and are protected by copyright and trade-mark laws. Please see the Disclaimer for further details.
The Province does not collect, use or disclose personal information through the ArcGIS Online website. Please be aware, however, that IP addresses are collected by Esri and are stored on Esri's servers located outside of Canada. For further information, including the purposes for which your IP address is collected, please see Esri's Privacy Policy at:http://www.esri.com/legal/privacy. By accessing or using the B.C. Map Hub, you consent, effective as of the date of such access or use, to Esri storing and accessing your IP address outside of Canada for the purposes described in Esri's Privacy Policy. Should you have any questions about the collection of your IP address, please contact BCGov AGOL CONTACT at , PO BOX 9864 STN PROV GOVT, Victoria BC V8W 9T5 / n/a / Mandatory
Thumbnail / Replace the default thumbnail for the gallery display with a photo or screenshot of the map. As per the Details Page Pop-up: "For best results, the image should be 200 pixels wide by 133 pixels high. Other sizes will be adjusted to fit. Acceptable image formats are: PNG, GIF and JPEG". If you'd like to add customize your image further, Here are links to the 'Thumbnail' generator software on GITHUB:
· https://github.com/Esri/thumbnail-builder-js
· http://nwdemo1.esri.com/thumbnailbuilder/ / Optional
4 WEB APPLICATION Details Page
4.1 Overview
As with Feature Layers and Web Services, when any item is created and is being saved for the first time, the user must enter content into the Title, Summary and Description and Tags (1 required). After the item has been saved this information can be revised, and additional information added, by editing the Details page for the item.
4.2 Content Requirements
The following is required for all web maps that are published to Public.
The content in the Details Page should be the same as the corresponding field in the BCDC Record as identified below. An example of where these guidelines have been applied include:
· The Network BC Connectivity Map
Item / Guideline / BCDC Record / Mandatory or Optional /Title / Should be short, easily distinguished/unique, and accurately describes the map / Title / Mandatory
Summary / Should be a subset of the Description (80 or so characters) with ... after. / n/a / Mandatory
Description / Should be a paragraph that explains the map purpose. For an Application, as the layers are not included in the Details page, include a user-friendly list of the data found in the map.
In addition to the Description from the BCDC record, also include the following:
BC Data Catalogue metadata: Clickable link for URL of the BCDC record using the Permalink.
If the data accessed is being hosted on the BCDC, include the following:
Data: Clickable link for URL of the BCDC record using the Permalink.
For example:
BC Data Catalogue metadata:
Map: https://catalogue.data.gov.bc.ca/dataset/cfdfcf1e-c3c8-4475-b12f-05d3ec7ef2e0
Data: https://catalogue.data.gov.bc.ca/dataset/17d8b94d-0a67-46c3-b974-fc164ae1a855
To obtain the Permalink go to the BCDC Record, and click on the Permalink button above the Title, then copy the URL and past into the Details Page.
/ Description / Mandatory
Tags / British Columbia and Canada must be included as Tags.
Include Keywords from the BCDC Record and additional tags that help people search for your map/application. / Keywords located under Description / Mandatory
Credits / Include the Sub-Organization from the BCDC Record. This is found immediately below the Title. Elections BC is the Sub-Organization. in this example "Published by the BC Agency - Elections BC". / Sub-Organization / Mandatory
Access and Use Constraints: / Include the following content (blue text only).
· Link to Copyright is: http://www2.gov.bc.ca/gov/content/home/copyright
· Link to Disclaimer is: http://www2.gov.bc.ca/gov/content/governments/about-the-bc-government/databc/geographic-data-and-services/agol/access-and-use-constraints
Content:
This map is Copyright ©, Province of British Columbia. All rights reserved.
The B.C. Map Hub and associated materials, including map applications ("Maps"), trade-marks and official marks (collectively, "Materials"), are owned or used under license by the Province of British Columbia ("Province") and are protected by copyright and trade-mark laws. Please see the Disclaimer for further details.
The Province does not collect, use or disclose personal information through the ArcGIS Online website. Please be aware, however, that IP addresses are collected by Esri and are stored on Esri's servers located outside of Canada. For further information, including the purposes for which your IP address is collected, please see Esri's Privacy Policy at:http://www.esri.com/legal/privacy. By accessing or using the B.C. Map Hub, you consent, effective as of the date of such access or use, to Esri storing and accessing your IP address outside of Canada for the purposes described in Esri's Privacy Policy. Should you have any questions about the collection of your IP address, please contact BCGov AGOL CONTACT at , PO BOX 9864 STN PROV GOVT, Victoria BC V8W 9T5 / n/a / Mandatory
Thumbnail / Replace the default thumbnail for the gallery display with a photo or screenshot of the map. As per the Details Page Pop-up: "For best results, the image should be 200 pixels wide by 133 pixels high. Other sizes will be adjusted to fit. Acceptable image formats are: PNG, GIF and JPEG". If you'd like to add customize your image further, Here are links to the 'Thumbnail' generator software on GITHUB:
· https://github.com/Esri/thumbnail-builder-js
· http://nwdemo1.esri.com/thumbnailbuilder/ / Optional
5 Branding Requirements
For "configurable" web map applications developed by use of Templates (such as Storybooks), the following options must be configured: