Map

    Description

    The Map Collection enables you to display a fully interactive world map with customizable points of interest. Each point of interest is assigned a specific latitude and longitude coordinate and can be represented by any IntuiFace component including buttons, assets and other collections.

    Map.gif

    Two map providers are available: Mapbox and Bing Maps.

    • Mapbox is a front end to Open Street Map, requires a personal account and permits highly detailed map and satellite views plus the ability to create custom maps and map styles. For more about Mapbox, see this section below.
    • Bing Maps requires a license key from Microsoft and permits map and satellite view with 20 levels of zoom as well as a choice of language options for labeling map locations. For more about Bing Maps, see this section below.

    In the following graphic, Image Buttons are used to label geographic coordinates. In the Map collection, any asset or collection can be assigned to geographic coordinates. Coordinate assignment can be created manually via drag-and-drop, imported from Excel or assigned via cloud-based resources.

    Map_WithPOI.jpg

    Selecting a Map Provider

    Using Mapbox

    Creating a Mapbox account and token

    The use of Mapbox map services requires an "API access token", a series of numbers and letters representing your personal Mapbox account. Without this token all maps in IntuiFace will display the message Invalid Access Token.

    To create a Mapbox account and generate an API access token, sign up here. After account creation, you will find your token here.

    NOTE: If your IntuiFace experiences will collectively generate fewer than 50k map views per month, the free Mapbox Starter plan will be sufficient. For additional monthly views - and for additional Mapbox capability - there are paid plans as well.

    In IntuiFace, when using the Mapbox option of the Maps collection, enter your token in the Access token field in the Mapbox section of the Appearance properties category.

    Customizing your Mapbox map

    Mapbox enables you to create your own maps and map styles.

    If not using a custom map or map style, simply set the Display Mode property to a map or satellite view.

    You can also use pre-defined styles

    • mapbox://styles/mapbox/dark-v9
    • mapbox://styles/mapbox/streets-v9
    • mapbox://styles/mapbox/outdoors-v9
    • mapbox://styles/mapbox/light-v9
    • mapbox://styles/mapbox/satellite-v9
    • mapbox://styles/mapbox/satellite-streets-v9
    • mapbox.mapbox-terrain-v2
    • mapbox.mapbox-streets-v7

    Or create your own:

    • Custom map: Use the Tileset editor in Mapbox Studio to create your map then copy the Map ID.
      Mapbox_MapId.jpg

      Paste that Map ID into the Map ID / Style URL property of the Map collection in Composer.


    • Custom style: Use the Style editor in Mapbox Studio. Once you've created your style, click the "Share, develop & use" menu option on the right.


      Then, in the "Develop with this style" section, copy the Style URL.
      Mapbox_StyleUrl.jpg

      Paste that Style URL into the Map ID / Style URL property of the Map collection in Composer.

    Using Bing Maps

    The use of Bing Maps requires a license key provided by Microsoft. Without this key:

    • on Windows: All maps will display the message Invalid Credentials.
    • on iPad, Android and Samsung SSP: All maps will be blank.

    In some cases this license key can be provided free of charge. It depends on the way you intend to use Bing Maps and on the status of your company.

    Please visit the following sites to get more information about the acquisition of Bing Maps licenses:

    Once you have an Account ID, use the Bing Maps “Create or View Keys” option to produce a license key. The key consists of a long series of numbers and letters. Enter your key in the Bing Maps key field in the Appearance properties category of the Map collection.

    How to add a point of interest to a map

    Every button, asset or collection added to a map inherits two new properties: Latitude and Longitude. These properties appear in the General Properties panel at the top of the**Properties panel.**

    POI.jpg

    These Latitude and Longitude properties can either be manually specified directly in the Properties panel or linked to an outside source through the use of binding. With binding, the location of your points of interest do not need to be known at design time.

    Outside data sources can be accessed through an Excel file, a .Net DLL or a REST Web Service

    You can open a Sample directly in Composer.

    Map-sample.jpg

    How to pan and zoom a map

    While in Edit Mode, a double-click on the Map collection will enable you to interact with the map directly. Left-click-and-drag to pan the map, use your mouse wheel to zoom in and out. This is a quick method for setting up the exact view your require in your map.

    To ensure map interactivity while in Play Mode, make sure the map's Container property is set to Static or to Pin with the Pinned button active.

    Map_EditMode.jpg

    Supported geocoordinate formats

    There are multiple geographic coordinate notation systems, from E6 notation - e.g. 40782710,-73965310 - to Degrees-Minutes-Seconds (DMS) notation - e.g. N40°46′57.756″ W73°57′55.116″. (These two previous examples represent the same exact location on a map.)

    Manual entry of latitude and longitude coordinates for a map or map item in a Map Collection, using the Properties panel, must obey Decimal Degrees notation. In Decimal Degrees notation, the number of degrees is represented before the decimal point and the number of minutes and seconds is represented as a multi-digit fraction after the decimal point. For example, Central Park in New York City is found at the latitude/longitude coordinate of 40.7821987, -73.9668703.

    Map_CentralPark.jpg

    When entering geocoordinates via binding - using Microsoft Excel, a Web API or a C# dll as the geocoordinate source - all recognized formats are supported by IntuiFace. This means your data source could adopt any of the following formats (formats highlighted here in Wikipedia):

    • 40:26:46.302N 079:56:55.903W
    • 40°26′47″N 079°58′36″W
    • 40d 26′ 47″ N 079d 58′ 36″ W
    • 40.446195N 79.948862W
    • 40.446195, -79.948862
    • 40° 26.7717, -79° 56.93172
    • N40:26:46.302 W079:56:55.903
    • N40°26′47″ W079°58′36″
    • N40d 26′ 47″ W079d 58′ 36″
    • N40.446195 W79.948862

    In fact, through binding, IntuiFace's geocoordinate format support is flexible enough to extract coordinates from sentences, sentence fragments and garbled notation as long as latitude precedes longitude. Any of the following would be interpreted correctly by IntuiFace if passed in through binding:

    • (48.866667;2.3265)
    • (51° 31' 17,54'' N,0° 4'42,85'' W)
    • It's here : 38°53′42.37″N 77°2′11.64″W
    • Buenos Aires (-34.608331°, -58.371151°)
    • coord = (15:48:00 S 47:54:00 W)
    • "N19° 25′ 57.16″; W 99° 7′ 53.89″"
    • Beijing = 39903546;116387578
    • S41.298734 E174.781237
    • (35 d 18' 29,86" S, 149 d 7' 27,8" E)
    • Parlement [S33d55'31" ;E18d25'26"]
    • (-1.137387, 36.84009)
    • -121.929894116772,37.3885586168933,0
    • 37.4411509194609,-122.156298769629,0.0

    Properties, Triggers & Actions

    Properties

    See common collection properties for details of common properties shared by different all collection types

    Appearance

    • Map provider --> specify whether you want to use Mapbox or Bing Maps
      • If Mapbox is selected, two additional properties appear
        • Access token --> an access token from your Mapbox account. For more information, see this section.
        • Map ID / Style URL --> specify a custom Mapbox map or style to use instead of the one selected by the Display Mode. For more information, see this section.
      • If Bing Maps is selected, two additional properties appear
        • Bing Maps key --> the license key acquired from Microsoft. For more information, see this section.
        • Language --> set the language used for geographic labels
    • Display mode --> specify whether you want a map, satellite or satellite with labels view
    • Latitude --> defines the initial latitude of the map
    • Longitude --> defines the initial longitude of the map
    • Zoom --> defines the initial zoom level of the map
    • Show icons --> display an asset type icon for each asset embedded in the Map collection

    Map_AppearanceProperties.jpg

    Behavior

    • Allow pan --> enable users to move the map in any compass direction
    • Allow zoom --> enable users to zoom in and out of the map
    • Double-tap to zoom --> toggles whether a double-tap on the map will initiate a zoom one step closer
    • Cache map when manipulated --> toggles whether a local copy of all visited map tiles should be saved to the Windows PC running Player or Composer. Once you have visited an area, the Map collection will no longer download its associated tile, using the local copy instead. Tiles are stored in the folder {User}\AppData\Local\Temp\IntuiFace\TilesCache. You can only clear this cache manually using Windows Explorer.
      • Map caching is not available on the iPad or Android tablets.
      • Works with both Mapbox and Bing Maps.
      • Map tiles in the TilesCache folder can be copied from one PC to another. As a result, one does not have to prebrowse every map instance on every PC running a given experience.

    MAp-behavior.jpg

    Triggers

    See Triggers Overview to get details of common triggers shared by all assets or collections

    • Display mode is changed: Raised when the display mode is changed. This trigger raises the following parameters:
      • New display mode
      • Old display mode
    • Viewport is changed: Raised when this map's viewport is changed. This trigger raises the following parameters:
      • Latitude
      • Longitude
      • Zoom

    MAp-Triggers.jpg

    Actions

    See Actions Overview to get details of common actions shared by all assets or collections

    • Center on item: Center on item using its Name property.
      • Item name: the name of the item to center the map on.
    • Close all opened collection items: Closes all opened collection items.
    • Set display mode: Sets the display mode of this map.
      • Display mode: the new display mode to use among Map / Satellite / Satellite with labels
    • Set viewport:Set current map viewport
      • Latitude
      • Longitude
      • Zoom
    • Set viewport boundary: Set current viewport boundary
      • Top left latitude
      • Top left longitude
      • Bottom right latitude
      • Bottom right longitude

    Map-actions.jpg