FGPV_schema_doc

The Federal Geospatial Platform Viewer (FGPV) schema V. 2.3

The schema.json file can be found here

Map 🚧
UI
Services
Version
Language

Map

Core map properties (extent sets, levels of detail).

Map JSON tree

"map": {
"extentSets": [
{
extentSetNode
},
{...},
{...},
...
],
"lodSets": [
{
lodSetNode
},
{...},
{...}
...
],
"tileSchemas": [
{
tileSchemaNode
},
{...},
{...}
...
],
"components": {
"geoSearch": {
"enabled": ...,
"showGraphic": ...,
"showInfo": ...
},
"mouseInfo": {
"enabled": ...,
"spatialReference": {...}
},
"northArrow": {
"enabled": ...,
"arrowIcon": ...,
"poleIcon": ...
},
"overviewMap": {
"enabled": ...,
"expandFactor": ...
},
"scaleBar": {
"enabled": ...
},
"basemap": {
"enabled": ...
}
},
"initialBasemapId": ...,
"baseMaps": { 🚧 },
"layers": { 🚧 },
"legend": { 🚧 }
}

ExtentSetNode JSON tree

{
"id": ...,
"spatialReference": {
"wkid": ...
},
"default": {...},
"full": {...},
"maximum": {...}
}

⬆️ back to Map

lodSetNode JSON tree

{
"id": ...,
"lods": [
{
"level": ...,
"resolution": ...,
"scale": ...
},
{...},
{...},
...
]
}

⬆️ back to Map

tileSchemaNode JSON tree

{
"id": ...,
"name": ...,
"extentSetId": ...,
"lodSetId": ...,
"overviewUrl": {
"layerType": ...,
"url": ...
}
},

⬆️ back to Map

map

Core map properties (extent sets, levels of detail).

Type	Author section	Advance	Required
object	Map/Extents and Levels of Details	-	-

⬆️ back to Map

map:extentSets

The default, full and maximum extents of the map. |

Type	Author section	Advance	Required
array	Map/Extents and Levels of Details	-	-

⬆️ back to Map

map:lodSets

The levels of detail (zoom scales) available for the map.

Type	Author section	Advance	Required
array	Map/Extents and Levels of Details	-	Yes

⬆️ back to Map

map:tileSchemas

A unique combination of an LoD and an extent set (each basemap must fit into a tile schema).

Type	Author section	Advance	Required
array	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to Map

map:components

Map components.

Type	Author section	Advance	Required
object	Map/Components	-	-

⬆️ back to Map

map:components:geoSearch

geoSearch component.

Type	Author section	Advance	Required
object	Map/Components	-	-

⬆️ back to Map

map:components:geoSearch:enabled

Enabling geoSearch. If this component is disabled, the geoSearch widget won't be shown in the application bar.

Type	Default value	Example	Author section	Advance	Required
boolean	true	`true`	Map/Components	-	-

⬆️ back to Map

map:components:geoSearch:showGraphic

Type	Default value	Example	Author section	Advance	Required
boolean	-	`true`	Map/Components	-	-

⬆️ back to Map

map:components:geoSearch:showInfo

Type	Default value	Example	Author section	Advance	Required
boolean	-	`true`	Map/Components	-	-

⬆️ back to Map

map:components:mouseInfo

Display cursor coordinates at the bottom of the screen.

Type	Author section	Advance	Required
object	Map/Components	-	-

⬆️ back to Map

map:components:mouseInfo:enabled

Enabling mouse information at the bottom of the screen.

Type	Default value	Example	Author section	Advance	Required
boolean	-	`true`	Map/Components	-	-

⬆️ back to Map

map:components:mouseInfo:spatialReference

Coordinates system and projection used to retrieve localization info from the mouse cursor. For more info see node:spatialReference_

⬆️ back to Map

map:components:northArrow

Everything about the North arrow

Type	Author section	Advance	Required
object	Map/Components	-	-

⬆️ back to Map

map:components:northArrow:arrowIcon

The graphical icon url/data url of the north arrow.

Type	Default value	Example	Author section	Advance	Required
string	-	`"data:image/png;base64,image encoded"`	Map/Components	-	-

⬆️ back to Map

map:components:northArrow:poleIcon

The graphical icon url/data url of the north pole that replaces north arrow when it's on north pole.

Type	Default value	Example	Author section	Advance	Required
string	-	`"data:image/png;base64,image encoded"`	Map/Components	-	-

⬆️ back to Map

map:components:northArrow:enabled

Enabling North arrow.

Type	Default value	Example	Author section	Advance	Required
boolean	true	`true`	Map/Components	-	-

⬆️ back to Map

map:components:overviewMap

Collapsable overview map.

Type	Author section	Advance	Required
object	Map/Components	-	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
overviewMap : enabled	boolean		-	`true`	Map/Components	-	-
overviewMap : expandFactor	number		`2`	`5`	`true`	Map/Components	-

⬆️ back to Map

map:components:scaleBar

Scale bar.

Type	Author section	Advance	Required
object	Map/Components	-	-

Name	Type	Default value	Example	Author section	Advance	Required
scaleBar : enabled	boolean	-	`true`	Map/Components	-	-

⬆️ back to Map

map:components:basemap

Collapsable overview map.

Type	Author section	Advance	Required
object	Map/Components	-	-

Name	Type	Default value	Example	Author section	Advance	Required
basemap : enabled	boolean	-	`true`	Map/Components	-	-

⬆️ back to Map

map:initialBasemapId

Initial basemap to load. If not supplied viewer will select any basemap.

Type	Default value	Example	Author section	Advance	Required
string	`Viewer choice`	`"myBaseMapID"`	Map/Basemaps	-	-

⬆️ back to Map

Nodes

Nodes are objects that are part of other object definition

node:extentSetNode:id

Extents set id.

Type	Default value	Example	Author section	Advance	Required
string	`-`	`"EXT_Lambert_3978"`	Map/Extents and Levels of Details	-	Yes

⬆️ back to extentSetNode

node:extentSetNode:default

The default (starting) extent. For more info see node:extentNode.

Type	Author section	Advance	Required
object	Map/Extents and Levels of Details	-	-

⬆️ back to extentSetNode

node:extentSetNode:full

The full extent (should give good view of the whole map, not necessarily the maximum extent); default will be used if not supplied. For more info see node:extentNode.

Type	Author section	Advance	Required
object	Map/Extents and Levels of Details	-	-

⬆️ back to extentSetNode

node:extentSetNode:maximum

The maximum extent; full or default extents will be used if not supplied. For more info see node:extentNode.

Type	Author section	Advance	Required
object	Map/Extents and Levels of Details	-	-

⬆️ back to extentSetNode

node:spatialReference

Projection

Type	Author section	Advance	Required
object	Map	-	-

⬆️ back to Map

node:spatialReference:wkid

Well-known identifier.

Type	Default value	Example	Author section	Advance	Required
string	`-`	`3978`	Map	-	-

⬆️ back to Map

node:lodSetNode:id

Level of details Set id.

Type	Default value	Example	Author section	Advance	Required
string	`-`	`"LOD_Lambert_3978"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to lodSetNode

node:lodSetNode:lods

Level of details for a specific tile schema.

Type	Author section	Advance	Required
array	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to lodSetNode

node:lodSetNode:lods:level

A sequential integer that identify a level.

Type	Default value	Example	Author section	Advance	Required
number	`-`	`3`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to lodSetNode

node:lodSetNode:lods:resolution

The smallest spaces between two display elements expressed in map unit of the corresponding projection.

Type	Default value	Example	Author section	Advance	Required
number	`-`	`38364.660062653464`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to lodSetNode

node:lodSetNode:lods:scale

Ratio between distance measure on a map and the corresponding distance on the ground.

Type	Default value	Example	Author section	Advance	Required
number	`-`	`145000000`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to lodSetNode

node:tileSchemaNode:id

A unique id identifying a tile schema (combination of an extent set and a zoom scale).

Type	Default value	Example	Author section	Advance	Required
string	`-`	`"EXT_Lambert_3978#LOD_Lambert_3978"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to tileSchemaNode

node:tileSchemaNode:name

The name to display in the basemap selector for the set of basemaps referencing this schema.

Type	Default value	Example	Author section	Advance	Required
string	`-`	`"Lambert Maps"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to tileSchemaNode

node:tileSchemaNode:extentSetId

The extent set to be used for this basemap (should reference map.extentSets.id).

Type	Default value	Example	Author section	Advance	Required
string	`-`	`"EXT_Lambert_3978"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to tileSchemaNode

node:tileSchemaNode:lodSetId

Optional. The level of details set to be used for this basemap.

Type	Default value	Example	Author section	Advance	Required
string	`-`	`"LOD_Lambert_3978"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to tileSchemaNode

node:tileSchemaNode:overviewUrl

Optional. If set, the overview map will use this layer instead of the active basemap.

Type	Author section	Advance	Required
object	Map/Extents and Levels of Details	Yes	-

⬆️ back to tileSchemaNode

node:tileSchemaNode:overviewUrl:layerType

Layer type that can be of one of those values ["esriImage", "esriTile"]

Type	Default value	Example	Author section	Advance	Required
string	-	`"esriTile"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to tileSchemaNode

node:tileSchemaNode:overviewUrl:url

The service endpoint of the layer. It should match the type provided in [layerType]((#maptileschemasoverviewurllayertype).

Type	Default value	Example	Author section	Advance	Required
string	-	`"https://services.arcgisonline.com/.../World_Street_Map/MapServer"`	Map/Extents and Levels of Details	Yes	Yes

⬆️ back to tileSchemaNode

node:extentNode

Extents coordinates in projection system used by the layer.

Name	Type	Default value	Example	Author section	Advance	Required
xmin	number	`-`	`-2681457`	Map	-	-
ymin	number	`-`	`-883440`	Map	-	-
xmax	number	`-`	`3549492`	Map	-	-
ymax	number	`-`	`3482193`	Map	-	-

⬆️ back to Map top

UI

User Interface configuration

UI JSON tree

"ui": {
"fullscreen": ...,
"theme": ...,
"logoUrl": ...,
"title": ...,
"restrictNavigation": ...,
"failureFeedback": {
"failureMessage": ...,
"failureImageUrl": ...
},
"appBar": {
"sideMenu": ...,
"geoSearch": ...,
"basemap": ...,
"layers": ...
},
"navBar": {
"extra": ...
},
"sideMenu": {
"logo": ...,
"items": [ ]
},
"about": {
"content": ...,
OR
"folderName": ...
},
"help": {
"folderName": ...,
},
"legend": {
"reorderable": ...,
"allowImport": ...,
"isOpen": {
"large": ...,
"medium": ...,
"small": ...
}
},
"tableIsOpen": {
"id": ...,
"large": ...,
"medium": ...,
"small": ...
}
}

ui

User Interface configuration.

Type	Author section	Advance	Required
object	UI	-	-

⬆️ back to UI

ui:fullscreen

Indicates viewer takes up entire viewport at first load.

Type	Default value	Example	Author section	Advance	Required
boolean	`false`	`false`	UI/General	-	-

⬆️ back to UI

ui:theme

UI theme of the viewer. For now, only "default" value is available

Type	Default value	Example	Author section	Advance	Required
string	`"default"`	`"default"`	UI/TBD	-	-

⬆️ back to UI

ui:logoUrl

An optional image to be used in the place of the default viewer logo.

Type	Default value	Example	Author section	Advance	Required
string	-	`"data:image/png;base64,image encoded"`	UI/Side Menu	Yes	-

⬆️ back to UI

ui:title

An optional title to be used in the place of the default viewer title.

Type	Default value	Example	Author section	Advance	Required
string	-	`My custom title`	UI/Side Menu	-	-

⬆️ back to UI

ui:restrictNavigation

Will restrict the user from panning beyond the maximum extent.

Type	Default value	Example	Author section	Advance	Required
boolean	`false`	`false`	UI/Navigation	-	-

⬆️ back to UI

ui:failureFeedback

Failure information.

Type	Author section	Advance	Required
object	UI/General	Yes	-

⬆️ back to UI

ui:failureFeedback:failureMessage

An optional message to be used in place of the failure message.

Type	Default value	Example	Author section	Advance	Required
string	-	`"That's a fail :-("`	UI/General	Yes	-

⬆️ back to UI

ui:failureFeedback:failureImageUrl

An optional image to be used in place of the failure Image.

Type	Default value	Example	Author section	Advance	Required
string	-	`"https://path2Image/MyFailureImage.gif"`	UI/General	Yes	-

⬆️ back to UI

ui:appBar

Provides configuration to the main app toolbar. If not supplied, the default appbar controls are displayed. To completely hide the toolbar, provide the following: { sideMenu: false, geoSearch: false, layers: false }.

Type	Author section	Advance	Required
object	UI/Application Bar	-	-

⬆️ back to UI

ui:appBar:sideMenu

Shows the side menu button in the main app toolbar.

Type	Default value	Example	Author section	Advance	Required
boolean	`true`	`true`	UI/Application Bar	-	-

⬆️ back to UI

ui:appBar:geoSearch

Shows the geosearch button in the main app toolbar. The button will be hidden if geosearch component is disabled or no search service URLs are provided.

Type	Default value	Example	Author section	Advance	Required
boolean	`true`	`true`	UI/Application Bar	-	-

⬆️ back to UI

ui:appBar:basemap

Shows the basemap selector button in the main app toolbar.

Type	Default value	Example	Author section	Advance	Required
boolean	`true`	`true`	UI/Application Bar	-	-

⬆️ back to UI

ui:appBar:layers

Shows the layers button in the main app toolbar.

Type	Default value	Example	Author section	Advance	Required
boolean	`true`	`true`	UI/Application Bar	-	-

⬆️ back to UI

ui:navBar

Provides configuration to the nav bar. If not supplied the default nav bar buttons are shown.

Type	Author section	Advance	Required
object	UI/Navigation	-	-

⬆️ back to UI

ui:navBar:extra

Set visible navigation bar buttons. Possible values: "geoLocator", "home", "basemap", "help", "fullscreen", "geoSearch", "sideMenu", "layers"

Type	Default value	Example	Author section	Advance	Required
array	`["fullscreen", "geoLocator", "home", "help"]`	`["home", "help", "fullscreen", "geoSearch", "sideMenu", "layers"]`	UI/Navigation	-	-

⬆️ back to UI

ui:sideMenu

Specifies which options are available in the left side menu.

Type	Author section	Advance	Required
object	UI/Side Menu	-	-

⬆️ back to UI

ui:sideMenu:logo

Indicates if the logo should be shown in the left side menu.

Type	Default value	Example	Author section	Advance	Required
boolean	`true`	`true`	UI/Side Menu	Yes	-

⬆️ back to UI

ui:sideMenu:items

Side Menu set of buttons. Divide the menu using array symbols []. Possible values are "layers", "basemap", "geoSearch", "about", "fullscreen", "export", "share", "touch", "help", "language", "plugins"

Type	Default value	Example	Author section	Advance	Required
array	`[["layers", "basemap"], ["fullscreen", "export", "share", "touch", "help", "about"], ["language"], ["plugins"]]`	`[["layers", "basemap"], ["fullscreen", "export", "about"], ["language"]]`	UI/Side Menu	-	-

⬆️ back to UI

ui:about

Specifies the location/content of the about section.

Type	Author section	Advance	Required
object	UI/Side Menu	-	-

⬆️ back to UI

ui:about:content

The content of the about section.

Type	Default value	Example	Author section	Advance	Required
string	-	`"This is about about"`	UI/Side Menu	-	-

⬆️ back to UI

ui:about:folderName

Help folder name which contains the about file(s) and image(s). The viewer will look inside a folder named about for the specified folder name (e.g. /about/aboutisHere). Afterward, it'll check for a markdown file named en-CA.md if you are in the English flavor of the viewer and fr-CA.md for the French. Images need to reside inside the specified folder.

Type	Default value	Example	Author section	Advance	Required
string	-	`aboutIsHere`	UI/Side Menu	-	-

⬆️ back to UI

ui:help

Specifies details for the Help section.

Type	Author section	Advance	Required
object	UI/Side Menu	Yes	-

⬆️ back to UI

ui:help:folderName

Help folder name which contains the help description and image(s). The viewer will look inside a folder named help for the specified folder name (e.g. /help/helpIsHere). Afterward, it'll check for a markdown file named en-CA.md if you are in the English flavor of the viewer and fr-CA.md for the French. Images need to reside inside the specified folder. NOTE The viewer has already a default help. Consequently, you will use this parameter only if you want a custom help.

Type	Default value	Example	Author section	Advance	Required
string	-	`HelpIsHere`	UI/Side Menu	Yes	Yes

⬆️ back to UI

ui:legend

Specifies options for the legend like reordering, importing, etc.

Type	Author section	Advance	Required
object	UI/General	-	-

⬆️ back to UI

ui:legend:reorderable

Specifies if the items in the legend can be reordered; structured legend ignores this property.

Type	Default value	Example	Author section	Advance	Required
boolean		`true`	`true`	UI/General	-

⬆️ back to UI

ui:legend:allowImport

Specifies if the user-added layers are allowed.

Type	Default value	Example	Author section	Advance	Required
boolean	`true`	`true`	UI/General	-	-

⬆️ back to UI

ui:legend:isOpen

Specifies whether the legend is opened by default on initial loading of the map for small, medium, and large viewports. ||| UI/General.

Type	Author section	Advance	Required
object	UI/General	-	-

⬆️ back to UI

ui:legend:isOpen:large

Whether the legend is opened by default on initial loading of the map for large viewports.

Type	Default value	Example	Author section	Advance	Required
boolean	`false`	`false`	UI/General	-	-

⬆️ back to UI

ui:legend:isOpen:medium

Whether the legend is opened by default on initial loading of the map for medium viewports.

Type	Default value	Example	Author section	Advance	Required
isOpen : medium	boolean	`false`	`false`	UI/General	-

⬆️ back to UI

ui:legend:isOpen:small

Whether the legend is opened by default on initial loading of the map for small viewports.

Type	Default value	Example	Author section	Advance	Required
boolean		`false`	`false`	UI/General	-

⬆️ back to UI

ui:tableIsOpen

A set of service endpoints used by the viewer.

Type	Author section	Advance	Required
object	UI/General	Yes	-

⬆️ back to UI

Type	Default value	Example	Author section	Advance	Required
tableIsOpen : id	string	The id of the layer for referencing within the viewer.	-	`"mylayerID"`	UI/General

⬆️ back to UI

ui:tableIsOpen:large

Whether the table panel is opened by default on initial loading of the map for large viewports.

Type	Default value	Example	Author section	Advance	Required
boolean	`false`	`false`	UI/General	Yes	-

⬆️ back to UI

ui:tableIsOpen:medium

Whether the table panel is opened by default on initial loading of the map for medium viewports.

Type	Default value	Example	Author section	Advance	Required
boolean	`false`	`false`	UI/General	Yes	-

⬆️ back to UI

ui:tableIsOpen:small

Whether the table panel is opened by default on initial loading of the map for small viewports.

Type	Default value	Example	Author section	Advance	Required
boolean	`false`	`false`	UI/General	Yes	-

⬆️ back to UI

Services

A set of service endpoints used by the viewer.

Services JSON tree

"services": {
"proxyUrl": ...,
"exportMapUrl": ...,
"geometryUrl": ...,
"googleAPIKey": ...,
"search": {
"disabledSearches": [...],
"serviceUrls": {
"geoNames": ...,
"geoLocation": ...,
"geoSuggest": ...,
"provinces": ...,
"types": ...,
}
},
"export": {
"title": {
"isSelected": ...,
"isSelectable": ...,
"value": ...
},
"map": {
"isSelected": ...,
"isSelectable": ...
},
"mapElements": {
"isSelected": ...,
"isSelectable": ...
},
"legend": {
"isSelected": ...,
"isSelectable": ...
},
"footnote": {
"isSelected": ...,
"isSelectable": ...
"value": ...
},
"timestamp": {
"isSelected": ...,
"isSelectable": ...
}
}
}

Services properties and definitions

services

A set of service endpoints used by the viewer.

Type	Default value	Example	Author section	Advance	Required
object			Services	-	-

⬆️ back to Services

services:proxyUrl

An optional proxy to be used for dealing with same-origin issues. URL must either be a relative path on the same server or an absolute path on a server which sets CORS headers.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"http://.../ProxyEndPoint"`	Services/Service End Points	Yes	-

⬆️ back to Services

services:exportMapUrl

An ESRI service endpoint for generating map images. Should point directly to an endpoint that can be consumed by ESRI PrintTask. NOTE: The PrintTask service has to be asynchronous.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"http://.../ExportMapEndPoint"`	Services/Service End Points	Yes	-

⬆️ back to Services

services:geometryUrl

A URL to an ESRI ArcGIS geometry service REST endpoint.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"http://.../GeometryEndPoint"`	Services/Service End Points	Yes	-

⬆️ back to Services

services:googleAPIKey

Google API key to enable geo location.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"AIzaSyBT6w4TvRdWFhFk35tc"`	Services/Service End Points	Yes	-

⬆️ back to Services

services:search

Search properties including ability to disable certain types of searches (NTS, FSA, and/or LAT/LNG) and to set service endpoint urls.

Type	Default value	Example	Author section	Advance	Required
object			Services/Geo Search	-	-

⬆️ back to Services

services:search:disabledSearches

Enable specific types of searches including: National Topographic System, Postal Code/Foward Sorting Area or Latitude/Longitude (e.g. 58.12;-100.67).

Type	Default value	Example	Author section	Advance	Required
array	`[]`	`["NTS","LAT/LNG"]`	Services/Geo Search	-	-

⬆️ back to Services

services:search:serviceUrls

Service endpoint urls.

Type	Default value	Example	Author section	Advance	Required
object			Services/Geo Search	Yes	-

⬆️ back to Services

services:search:serviceUrls:geoLocation

Endpoint url for geoLocation service.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"https://.../en/locate?q="`	Services/Geo Search	Yes	-

⬆️ back to Services

services:search:serviceUrls:geoNames

Endpoint url for geoNames service.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"https://.../en/geonames.json"`	Services/Geo Search	Yes	-

⬆️ back to Services

services:search:serviceUrls:geoSuggest

Endpoint url for geoSuggest service.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"https://.../en/suggest?q="`	Services/Geo Search	Yes	-

⬆️ back to Services

services:search:serviceUrls:provinces

Endpoint url for provinces service

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"https://.../en/codes/province.json"`	Services/Geo Search	Yes	-

⬆️ back to Services

services:search:serviceUrls:types

Endpoint url for types service.

Type	Default value	Example	Author section	Advance	Required
string	`""`	`"https://.../en/codes/concise.json"`	Services/Geo Search	Yes	-

services:export

Export properties.

Type	Author section	Advance	Required
object	Services/Export Map	-	-

⬆️ back to Services

services:export:title

Export title's properties.

Type	Author section	Advance	Required
object	Services/Export Map	-	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
title : isSelectable	boolean		`true`	`true`	Services/Export Map	-	-
title : isSelected	boolean		`true`	`true`	Services/Export Map	-	-
title : value	string	Value to appear by default	`""`	`"My map title"`	Services/Export Map	-	-

⬆️ back to Services

services:export:map

Map component.

Type	Author section	Advance	Required
object	Services/Export Map	Yes	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
map : isSelectable	boolean		`true`	`true`	Services/Export Map	Yes	-
map : isSelected	boolean		`true`	`true`	Services/Export Map	Yes	-

⬆️ back to Services

services:export:mapElements

North arrow and scalebar component.

Type	Author section	Advance	Required
object		Services/Export Map	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
mapElements : isSelectable	boolean		`true`	`true`	Services/Export Map	-	-
mapElements : isSelected	boolean		`true`	`true`	Services/Export Map	-	-

⬆️ back to Services

services:export:legend

Legend component.

Type	Author section	Advance	Required
object	Services/Export Map	Yes	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
legend : isSelectable	boolean		`true`	`true`	Services/Export Map	-	-
legend : isSelected	boolean		`true`	`true`	Services/Export Map	-	-

⬆️ back to Services

services:export:footnote

Foot notice to add to exported map.

Type	Author section	Advance	Required
object	Services/Export Map	Yes	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
footnote : isSelectable	boolean		`true`	`true`	Services/Export Map	-	-
footnote : isSelected	boolean		`true`	`true`	Services/Export Map	-	-
footnote : value	string	Footnote value to appear by default	`""`	`"This is a foot notice"`	Services/Export Map	-	-

⬆️ back to Services

services:export:timestamp

Timestamp component.

Type	Author section	Advance	Required
object	Services/Export Map	-	-

Name	Type	Description	Default value	Example	Author section	Advance	Required
timestamp : isSelectable	boolean		`true`	`true`	Services/Export Map	-	-
timestamp : isSelected	boolean		`true`	`true`	Services/Export Map	-	-

⬆️ back to Services

Version

The schema version used to validate the configuration file. The schema should enumerate the list of versions accepted by this version of the viewer.

"version": "2.2"

Language

ISO 639-1 code indicating the language of strings in the schema file.

ISO 639-1 code	Language	Default
"en"	English	Yes
"fr"	French

"language": "en"

Annex

ui : fullscreen

    "ui"{
        ...,
        "fullscreen": true,
        ...
    }

⬆️ back to fullscreen

ui : theme

    "ui"{
        ...,
        "theme": "default",
        ...
    }

⬆️ back to theme

ui : logoUrl

Note: if you want your custom logo to be shown, you have to set "sideMenu" {"logo": true} (see sideMenu)

    "ui"{
        ...,
        "logoUrl": "data:image/png;base64,image encoded",
        ...
    }

⬆️ back to logoUrl

ui : title

    "ui"{
        ...,
        "title": "Custom title",
        ...
    }

title

⬆️ back to title

ui : restrictNavigation

    "ui"{
        ...,
        "restrictNavigation": true,
        ...
    }

⬆️ back to restrictNavigation

ui : failureFeedback

    "ui"{
        ...,
        "failureFeedback": {
            "failureMessage": "That's a fail :-(",
            "failureImageUrl":"https://files.gitter.im/AleksueiR/eR5s/dinoscream.gif"
        },
        ...
    }

failureFeedback

⬆️ back to failureFeedback

ui : appBar

The application bar could be found at the top left corner of the viewer.

    "ui"{
        ...,
        "appBar": {
            "sideMenu": true,
            "geoSearch": true,
            "basemap": true,
            "layers": true
        },
        ...
    }

Putting false to an element will hide it. Also, basemap button will appear only after layers button has been pushed.

appBar

⬆️ back to appBar

ui : navBar

The application bar could be found at the bottom right corner of the viewer.

    "ui"{
        ...,
        "navBar": {
            "extra": ["fullscreen", "geoLocator", "home", "help", "basemap", "geoSearch", "sideMenu", "layers"]
        },
        ...
    }

navBar

⬆️ back to navBar

ui : sideMenu

The sidemenu can be accessed through button.

This code snippet will generate a sidemenu containing four categories with a title and a logo at the top. A custom logo can be defined here and a custom title here.

    "ui"{
        ...,
        "sideMenu": {
            "logo": true,
            "items": [["layers", "basemap"], ["fullscreen", "export", "share", "touch", "help"], ["language"], ["plugins"]]
        },
        ...
    }

sideMenu

⬆️ back to sideMenu

ui : about

The about section can be accessed in the sidemenu. NOTE You can't put both content and folderName they are mutually exclusive.

    "ui"{
        ...,
        "about": {
            "content": "This is about the about section"
            OR
            "folderName": "indexOne"
        },
        ...
    }

Here's an example with content. ui-about-content.gif

about content

Here's an example with a folderName. The folder is structured like this:

about\
    indexOne\
        images\
            canada.png
        en-CA.md
        fr-CA.md

about folderName

⬆️ back to about

ui : help

The help section can be accessed in the sidemenu or in the navigation bar.

    "ui"{
        ...,
        "help": {
            "folderName": "myHelp"
        },
        ...
    }

Here's the corresponding files and folders structure:

help\
    myHelp\
        images\
            image1.png
            image2.png
            ...
        en-CA.md
        fr-CA.md

⬆️ back to help

ui : legend

    "ui"{
        ...,
        "legend": {
            "isOpen": {
                "large": true,
                "medium": true,
                "small": false
        },
        ...
    }

⬆️ back to legend

ui : tableIsOpen

    "ui"{
        ...,
        "tableIsOpen": {
            "id": "DateLayer",
            "large": true,
            "medium": true,
            "small": false
        },
        ...
    }

⬆️ back to tableIsOpen

services : proxyUrl

You can find more information about proxy services here.

    "services"{
        ...,
        "proxyUrl": "http://.../ProxyEndPoint",
        ...
    }

⬆️ back to proxyUrl

services : exportMapUrl

You can find more information about exporting map to image services here.

    "services"{
        ...,
        "exportMapUrl": "http://.../ExportMapEndPoint",
        ...
    }

This service is used when you push the DOWNLOAD button of the export dialog window.

download

⬆️ back to exportMapUrl

services : geometryUrl

You can find more information about the geometry services here.

    "services"{
        ...,
        "geometryUrl": "http://.../GeometryEndPoint",
        ...
    }

⬆️ back to geometryUrl

services : googleAPIKey

You can find more information about the google API Key service here.

    "services"{
        ...,
        "googleAPIKey": "AIzaSyBT6w4TvRdWFhFk35tc",
        ...
    }

⬆️ back to googleAPIKey

services : search

    "services"{
        ...,
        "search": {
            "disabledSearches": [...],
            "serviceUrls": {...}
        }
        ...
    }

Searches can be done through the search bar.

⬆️ back to search

services : search : disabledSearches

Be cautious, the types of search identified in the array will be enabled in the viewer.

        "search": {
            "disabledSearches": ["NTS","LAT/LNG"],
            ...
        }

⬆️ back to search

services : search : serviceUrls

Default search services are provided by Natural Resources Canada and cover Canadian territories. You can find more information about thoses services here:

GeoLocation API: "geoLocation" and "geoSuggets"

GeoNames API: "geoNames", "provinces" and "types"

    "search": {
        "serviceUrls":{
            "geoNames":"https://geogratis.gc.ca/services/geoname/en/geonames.json",
            "geoLocation":"https://geogratis.gc.ca/services/geolocation/en/locate?q=",
            "geoSuggest":"https://geogratis.gc.ca/services/geolocation/en/suggest?q=",
            "provinces":"https://geogratis.gc.ca/services/geoname/en/codes/province.json",
            "types":"https://geogratis.gc.ca/services/geoname/en/codes/concise.json"
        },
        ...
    }

⬆️ back to serviceUrls

services : export

    "services"{
        ...,
        "export": {
            "title": {...},
            "map": {...},
            "mapElements": {...},
            "legend": {...},
            "footnote": {...},
            "timestamp": {...}
        },
        ...
    }

Accessing export dialog window

Access

Accessing the export settings can be done through the settings button . Each element of the settings panel can be selected or not by setting the attribute "isSelected" and show or hide in the panel with the use of "isSelectable".

Settings

⬆️ back to export

services : export : title

    "export": {
      ...,
      "title": {
        "isSelectable": true,
        "isSelected": true,
        "value": "Export custom title"
      },
      ...
    }

title

⬆️ back to title

services : export : map

    "export": {
      ...,
      "map": {
        "isSelectable": true,
        "isSelected": true
      },
      ...
    }

map

⬆️ back to map

services : export : mapElements

    "export": {
      ...,
      "mapElements": {
        "isSelectable": true,
        "isSelected": true
      },
      ...
    }

mapElements

⬆️ back to mapElements

services : export : legend

    "export": {
      ...,
      "legend": {
        "isSelectable": true,
        "isSelected": true
      },
      ...
    }

legend

⬆️ back to legend

services : export : footnote

    "export": {
      ...,
      "footnote": {
        "isSelectable": true,
        "isSelected": true,
        "value": "This a footnote from the configuration file."
      },
      ...
    }

footnote

⬆️ back to footnote

services : export : timestamp

    "export": {
      ...,
      "timestamp": {
        "isSelectable": true,
        "isSelected": false
      },
      ...
    }

timestamp

⬆️ back to timestamp

Schema

FGPV JSON schema
- Map
- UI
- Services
- Version
- Language

Version

Version update

Other

T & C of Use: English license | French license
Pull request process

Uh oh!

FGPV_schema_doc

The Federal Geospatial Platform Viewer (FGPV) schema V. 2.3

Map

Map JSON tree

map

Nodes

UI

UI JSON tree

ui

Services

Services JSON tree

Services properties and definitions

services

Version

Language

Annex

ui : fullscreen

ui : theme

ui : logoUrl

ui : title

ui : restrictNavigation

ui : failureFeedback

ui : appBar

ui : navBar

ui : sideMenu

ui : about

ui : help

ui : legend

ui : tableIsOpen

services : proxyUrl

services : exportMapUrl

services : geometryUrl

services : googleAPIKey

services : search

services : search : disabledSearches

services : search : serviceUrls

services : export

services : export : title

services : export : map

services : export : mapElements

services : export : legend

services : export : footnote

services : export : timestamp

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!