Cartes personnalisées dans MyGeotab
Implementation Guide
0 mins to read
Découvrez comment Geotab prend en charge les cartes personnalisées, une fonction qui permet à votre organisation de concevoir des cartes spécifiques à l’entreprise qui se combinent avec les informations sur les véhicules de l’application. Parmi les utilisations possibles, on peut citer les cartes qui montrent des informations centrées sur le client, les flux d’eau souterrains, les frontières municipales ou les infrastructures de la ville telles que l’électricité ou les égouts.
September 2025
Table of contents
Custom Map Builder
Geotab supports custom maps. This powerful feature allows your organization to design business-specific maps that combine with the application’s vehicle information. Some possible usages include maps that show customer-centric information, underground water flow, municipal boundaries, or city infrastructure (power, roads, sewage, etc).
The application supports custom map implementations based on OpenLayers https://openlayers.org/. Geotab currently supports four types of layers.
- xyz- Tile Server arranged by a standard XYZ grid
- osm - OpenStreetMap tiles
- wms - OGC Web Mapping Services
- ArcGIS93Rest - Mapping Services hosted by ArcGIS server 9.3 above
To add custom map configurations:
- Navigate to System > Settings from the main menu.
- On the System Settings page, select the Maps tab.
- Scroll to the Customer Web Maps section and click + Custom web map.
- Clicking on + Custom web map opens the New Custom Web Map window.
- Name your custom web map. Click Done to save your changes.
Navigating to Custom Map View
The custom map configuration can be accessed from the Map.
To access the custom map:
- Navigate to Map from the main menu.
- Click the layers icon on the bottom right and select Map Provider.
- Select your custom map configuration from the list.
Configure the Custom Map
Configure Map
The two parameters used in map configuration are units and projection. Please use the default value as shown below. Parameters are put inside the {}.
Parameter | Definition | Description |
“units” | The map unit. | It is an option. The default value is “m” or “meter” -"units": "meters", |
“projection” | The projected coordinate system used by the map. | It is an option. The default value is “EPSG:3857”. This is the Spherical Mercator projection coordinate system popularized by web services such as Google and later OpenStreetMapis. -- "projection": "EPSG:3857" |
Sample configure looks like :
{
"units": "m",
"projection": "EPSG:3857"
}
Configure Layers
Layers are the contents of your map and fall into two types: base layers and overlay layers.
- Base Layers: A map must have at least one base layer. You can include multiple base layers in a map, but only one can be active and visible at a time.
- Overlay Layers: You can have multiple overlay layers. By default, all overlay layers are visible, and you can individually toggle them on or off.
Layer Parameters
Parameter | Description |
“Type” | The available support types are “xyz”, ”osm”, "arcgis93rest",” wms”. |
“Name” | The layer name that is displayed in the layer selection window. |
“urls” | All urls must use HTTPS. |
“options" | Within “options”:
|
“Param” | Within “Param”:
|
Sample layer configuration
This is a sample layer configuration.
- Enclose the entire layer configuration in square brackets [ ].
- Enclose each individual layer in curly braces { }.
- Separate each layer in the list with a comma.
- Inside each layer, separate the parameters with a comma.
Sample layer configure looks like :
[
{
"type": "",
"name": "",
"urls": "https://yourdomain.com",
"options": {
"format": "png32",
"isBaseLayer": false
},
“Parameter”:{
}
},
{
"type": "",
"name": "",
"urls": "https://yourdomain.com",
"options": {
"format": "png32"
},
“Parameter”:{
}
}
]
XYZ - Custom Tile Server Template
Esri ArcGIS Online Tiled Map Service
This is to show the tile mapping service hosted on ArcGIS online account. The service REST URL must be accessible by the public.
{
"type": "xyz",
"name": "AGOL_Ohio_OrthoImage",
"urls": [
"https://tiles.arcgis.com/tiles/b8eHPJ5KRnX3dHNa/arcgis/rest/services/Ortho_Map_Tile_Package_2/MapServer/tile/${z}/${y}/${x}"
],
"options": {
"format": "png",
"isBaseLayer": false
}
}
Custom Tiled Map Service
Customers should provide a tile server access URL with {(level)/${x}/${y} in it. The URLs may need an access token or Api_key which will be appended after “?” at the end of the URL.
{
"type": "xyz",
"name": "Custom Tile Server with Token",
"urls": [ https://public_tiles.dronedeploy.com/v1/tiles_images/5dd7155658881675c4519c78/orthomosaic/${z}/${x}/${y}?token=eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InJvYmJAb3ZlcmxhbmR0ZWNobGxjLmNvbSIsImxheWVyIjoib3J0aG9tb3NhaWMiLCJwbGFuX2lkIjoiNWRkNzE1NTY1ODg4MTY3NWM0NTE5Yzc4IiwiZXhwIjoyMTQ1OTE2ODAwMDAwfQ.CxclXNYdzZR_cC3rAQOMRVgAkX7WpPRTi2cKI30FrrFZ1JzauNQfhyvIQplu-wshbJwGcZcJUVIduWsjcpzDhw"
],
"options": {
"format": "png",
"isBaseLayer": false
}
}
WMTS layer
WMTS (Web Map Tile Services) is one of OGC standards. Please provide XML capabilities using a URL similar to the following: https://services.arcgisonline.com/arcgis/rest/services/Demographics/USA_Population_Density/MapServer/WMTS/1.0.0/WMTSCapabilities.xml
{
"type": "xyz",
"name": "WMTS-xyz",
"urls": [ "https://services.arcgisonline.com/arcgis/rest/services/Demographics/USA_Population_Density/MapServer/WMTS/tile/1.0.0/Demographics_USA_Population_Density/default/default028mm/${z}/{y}/${x}"
],
"options": {
"format": "png",
"isBaseLayer": false
}
}
MapBox Tiles
To use the MapBox map layer, you will need 2 items: a Mapbox Access Token and a Mapbox Style URL.
{
"type": "xyz",
"name": "MapBox_Arron",
"urls": [
"https://api.mapbox.com/v3/aaront.map-7ocnj45k/${z}/${x}/${y}.png"
],
"options": {
"isBaseLayer": true
}
},
{
"type": "xyz",
"name": "MapBox_Satellite",
"urls": [
"https://api.mapbox.com/v4/mapbox.satellite/${z}/${x}/${y}.png?access_token=pk.eyJ1Ijoic2VyZW5hLWdlb3RhYiIsImEiOiJjazhvdGVoaWYxY3YzM21xeG90a2VzNTBlIn0.DLmRoo-4PR-jrqLjS0tNOA"
],
"options": {
"isBaseLayer": false
}
}
OSM Custom Tiles Template
Open Street Map
For more details refer to: https://wiki.openstreetmap.org/wiki/Tile_servers
{
"type": "osm",
"name": "OpenStreetMap",
"urls": "https://{a-c}.tile.openstreetmap.org/${z}/${x}/${y}.png",
"options": {
"isBaseLayer": true
}
}
WMS Custom Tiles Template
Web Map Services (WMS) are a standard from the OGC (Open Geospatial Consortium). To get information about a WMS, you need to request its GetCapabilities results. From the results, we will extract the URL and layer information. The request you submit will be similar to the one shown below.
Layers can have multiple layer names listed as a comma separated list.
https://idpgis.ncep.noaa.gov/arcgis/services/NWS_Observations/radar_base_reflectivity/MapServer/WMSServer?request=GetCapabilities&service=WMS
Canada Weather
{
"type": "wms",
"name": "WMS-Canada-RADAR_1KM_RSNO",
"urls": [
"https://geo.weather.gc.ca/geomet"
],
"options": {
"isBaseLayer": false
},
"params": {
"layers": "RADAR_1KM_RSNO"
}
}
NOAA Satellite
{
"type": "wms",
"name": "WMS-NOAA",
"urls": [
"https://idpgis.ncep.noaa.gov/arcgis/services/NWS_Observations/radar_base_reflectivity/MapServer/WMSServer"
],
"options": {
"isBaseLayer": false
},
"params": {
"layers": "1",
"Tiled": true
}
}
ArcGIS Rest URL Template
This ArcGIS REST URL Template is used to display map data from Map Service hosted by Esri ArcGIS server (version 9.3 and above). To use the template, the Map Service must have the “Export Map” feature and provide a REST URL.
Map Layer hosted by Esri ArcGIS Server
{
"type": "arcgis93rest",
"name": "StateCityHighway -USA",
"urls": [
"https://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Specialty/ESRI_StateCityHighway_USA/MapServer"
],
"options": {
"format": "png",
"isBaseLayer": false
},
"params": {
"layers": "show:2",
"layerDefs": "2:STATE_NAME='Ohio'"
}
}
** If Dynamic Layers option is in Export Map session ( ArcGIS Server 10.2 and above), “dynamicLayers” can be added as one of the params and change styles of the layers on the Geotab Map
for example :
{
"type": "arcgis93rest",
"name": "Snow Ops",
"urls": "https://xxx.xxx.com/arlgis/rest/services/Snow/Snow_Ops/MapServer",
"options": {
"format": "png32",
"isBaseLayer": false
},
"params": {
"layers": "show:0",
"FORMAT": "PNG32",
"TRANSPARENT": true,
"dynamicLayers": "[{'id':0,'name':'Snow Priority Routes','source':{'type':'mapLayer','mapLayerId':0},'drawingInfo':{'renderer':{'type':'uniqueValue','field1':'PLOWTYPE','field2':null,'field3':null,'fieldDelimiter':',','defaultSymbol':null,'defaultLabel':null,'uniqueValueInfos':[{'value':'1','symbol':{'color':[255,255,0,255],'width':2,'type':'esriSLS','style':'esriSLSSolid'},'label':'Primary County'},{'value':'2','symbol':{'color':[0,92,230,255],'width':2,'type':'esriSLS','style':'esriSLSSolid'},'label':'Secondary County'},{'value':'4','symbol':{'color':[76,230,0,255],'width':2,'type':'esriSLS','style':'esriSLSSolid'},'label':'School Priorities'},{'value':'3','symbol':{'color':[0,0,0,255],'width':2,'type':'esriSLS','style':'esriSLSSolid'},'label':'VDOT Maintained'}]},'showLabels':false},'minScale':0,'maxScale':0}]"
}
}
Learn more about how to get the "dynamicLayers" parameter at the following link. Remember to replace the double quotes " to single quotes '.
https://support.esri.com/en/technical-article/000015441
Limitations
- Visibility: Visibility is not working, as all overlay layers are turned on by default. You can toggle the checkbox to turn them on or off.
- Transparency: Map transparency is not working, as all overlays are not transparent by default.
