Map Block 


Introduction

In this tutorial, we show how to use Map Block.
 Map Block displays map related information, the key ones are:
  • Device GPS location
  • A set of POI (Point Of Interest) like restaurants, monuments etc.. These POI come from a Data Source.

How it works

EachScape will use either Google or Apple map automatically.
Map block uses a data source to display the Point Of Interest (POI).
The data source needs to associate longitude and Latitude with each POI to be displayed on the map.
When a user tap on a POI the Map Block triggers a Tap Event to which you associate any event.
 

IMPORTANT

1. Turn on GPS

To use the Map Block you need to turn on GPS in your app.

The Tutorial app 'GPS' illustrate how to turn on GPS and show how to display the device location on a map. Make sure to review that GPS Tutorial before proceeding.


2. Google MAP Key
If you are using an Android device: In order to use Google Map, Google requires a Map Key, you MUST enter a Map key to use the Map Block on Android.
To learn how to generate a Map Key from Google and correctly configure EachScape to use your Google Map Key, please review Configuring Map Key.

 

Video Tutorial on How to use Map Block

This video shows an older version of EachScape however the concepts remains exactly the same. We are in the process of updating our video.

 

Map Block Parameters

  

Center LatitudeThe center latitude of the map as initially displayed.
Center LongitudeThe center longitude of the map as initially displayed.
Show GPS LocationIf enabled, show and update the current GPS location.
Minimum Visible MilesThe extent of the map as initially displayed. If a minimum number of visible POIs is specified, the map may be resized to satisfy that constraint. This can be a floating point number, such as 0.25.
GPS LabelThe label for the GPS annotation.
GPS DetailThe detail below the label.
Show MarkerIf enabled, show a custom marker at the specified location.
Marker LatitudeThe latitude for the marker annotation.
Marker LongitudeThe longitude for the marker annotation.
Marker LabelThe label for the marker annotation.
Marker DetailThe detail below the label.
Marker ImageThe optional image used for the marker pin. If not set, a default pin image is used.
Show POIsIf enabled, show POI markers.
Minimum Visible POIsThe minimum number of POIs initially visible on the map. The map scale may be adjusted to satisfy this constraint.
Maximum Visible POIsThe maximum number of POIs visible on the map at any time.
POI Data SourceThe data source for Points of Interest.
POI LatitudeThe field in the POI Data Source that specifies the POI latitude.
POI LongitudeThe field in the POI Data Source that specifies the POI longitude.
POI LabelThe field in the POI Data Source that specifies the POI label.
POI DetailThe field in the POI Data Source that specifies the POI detail below the label.
POI ImageThe optional image used for the POI pin. If not set, a default pin image is used. Image will only display with local images in the Media folder. Can use Access By Name, to access the images.

Learn More

Configuring Map Key

-  GPS Tutorial