Version: 3.x

Geomap tool

The GeomapTool is a geolocation for the models and allow the user to place them on the maps. This will help in visulaize the model on top of map at specific geo location.

The tool provides list of options to set and choose:

  • Several map providers namely, Bing maps, Mapbox, Here maps and OpenStreet map.
  • We support planar mode and support terrain can be considered if needed.
  • Models can be placed on specific geolocation using latitude and longitude values.

Supported map providers

In Geomap tool, you can select from several different map providers:

  • Bing Maps
  • Mapbox
  • Here Maps
  • OpenStreet Maps

APIKeys

Each map providers needs respective API keys (Access Token) to be assigned. To get access token follow the below procedure.

Mapbox Maps

Configuration of the Mapbox are listed below which can be used to set different option for the maps.

  • 'mode': Map tile access mode.
    • MapboxMode.Style - These are pre-defined styles using map/tileset id, created in Mapbox Studio style editor. For more details see https://docs.mapbox.com/api/maps/styles/
      • MapboxStyle.Streets
      • MapboxStyle.Outdoor
      • MapboxStyle.Light
      • MapboxStyle.Dark
      • MapboxStyle.Satellite
      • MapboxStyle.Satellite_Streets
      • MapboxStyle.Navigation_Day
      • MapboxStyle.Navigation_Night
      • MapboxStyle.Navigation_Guide_Day
      • MapboxStyle.Navigation_Guide_Night
    • MapboxMode.Map_Id - A map/tileset ID is a unique identifier given to every tileset. For more details see https://docs.mapbox.com/help/glossary/tileset-id/
      • MapboxId.Streets
      • MapboxId.Satellite
      • MapboxId.Terrain
      • MapboxId.Traffic
      • MapboxId.TerrainRGB
  • 'APIKey': API access token of Mapbox.
  • 'id': Map style/Map Id to be used.
    • If MapboxMode.Style is choosen, than style value should passed such as MapboxStyle.Streets.
    • If MapboxMode.Map_Id is choosen, than Id value should passed such as MapboxId.Satellite.
  • 'tileFormat': Map image tile format.
    • MapboxImageFormat.PNG
    • MapboxImageFormat.PNG32
    • MapboxImageFormat.PNG64
    • MapboxImageFormat.PNG128
    • MapboxImageFormat.PNG256
    • MapboxImageFormat.JPG70
    • MapboxImageFormat.JPG80
    • MapboxImageFormat.JPG90
    • MapboxImageFormat.PNGRAW
  • 'latlong': Latitude & Longitude location where the model will be placed on the map.
Live Editor

Bing Maps

Configuration of the Bing Maps are listed below

  • 'APIKey': API access token of Bing Map.
  • 'type': The type of the map used.
    • BingMapType.Aerial
    • BingMapType.Road
    • BingMapType.Aerial_Labels
    • BingMapType.Oblique
    • BingMapType.Oblique_Labels
  • 'latlong': Latitude & Longitude location where the model will be placed on the map.
Live Editor

Here Maps

Configuration of the Here Maps are listed below

  • 'APIKey': API access token of Here Map.
  • 'appCode': Application code token of Here Map.
  • 'style': The type of maps to be used.
    • HereMapType.Aerial
    • HereMapType.Base
    • HereMapType.Pano
    • HereMapType.Traffic
  • 'scheme': Specifies the view scheme. Be aware that invalid combinations of schemes and tiles are rejected. For all satellite, hybrid and terrain schemes, you need to use the Aerial Tiles base URL instead of the normal one.
    • HereMapScheme.Day
    • HereMapScheme.Night
    • HereMapScheme.Terrain
    • HereMapScheme.Satellite.
  • 'imageFormat': Map image format.
    • HereMapImageFormat.PNG
    • HereMapImageFormat.PNG8
    • HereMapImageFormat.JPG
  • 'latlong': Latitude & Longitude location where the model will be placed on the map.
Live Editor

OpenStreet Maps

  • Only latitude & longitude configuration is needed for OpenStreet Maps.
  • 'latlong': Latitude & Longitude location where the model will be placed on the map.
Live Editor