Setting up Apple or Google Map Services
 for the Map Block


Introduction

In order to use Map services from Google or Apple you need to configure these services.


This Tutorial provide some guidances on how to set up these services for:

 



FOR GOOGLE MAP ON ANDROID


When using the Map Block on Android you will need to:

  • Create a Public API access Key on the Google Developers Console. 
  • You need to setup a Google Developers account to utilize these features.


Once logged in on Google Developers Console:

  • Select the Google Maps Android API 
  •  The API key uniquely identify your app with Google.
  • Then select  "Credentials", configure it for the type of user you are looking for (Android app / iOS app etc..)

 

 
  • Create the Key



Add the API Key in EachScape Studio

 
Now you can paste the API key you just generated into EachScape Studio.

Go to your app
Under 'Configure'
Select the "Plugins" tab
 



Within that section paste the API key into the following fields
 
"Google Simple API Key"
AND "Google Simple Api Key For Ad Hoc Builds" 

 


The Map Block will work for Android Ad Hoc builds.



Uniquely Sign your App to use Google Services

This is optional for AdHoc but required for your commercial build.

Google lets you uniquely identify the app allowed to use Google Services (in our case map API)

 To uniquely identify an app 2 parameters are required:
  • Hash Key
  • Keystore
The identification is done through the Google Developers Console BEFORE you create your key.
You need to add a Package and Fingerprint.

Select the 'Add package name and fingerprint'
When you select Add package and fingerprint you are required to add the following information:
  • Pacakge name
  • SHA-1 certificate fingerprint

Screenshot from Google Console:

For AdHoc


SHA-1 certificate fingerprint
All EachScape adhoc build uses the same SHA-1 certificate fingerprint
Use the following:
03:CD:7D:A6:48:DF:1A:A1:CC:53:2A:C3:88:14:44:84:86:FA:A6:01

Package name
To determine the package name to use do the following:
Check the URL in your browser: It will be something like: 

Then your package name will be:
com.eachscape.app5218

adhoc pacakge name always use the following syntax
com.eachscape.xxxx
Where the .xxxx is constructed as shown above.


In this example, the hash key and keystore will look like:

 
Now hit Save to create the uniquely identified API key for Android applications.


For Android Commercial builds:

You will need a Package name that is created after you setup your Android Keystore for your Android Commercial build.

Select the 'Manage' Tab

Then select Android keystore (You need a permission to access the Android Keystore, this will be accessible to all users by June 1st, 2016)

 Click on the keystore to show the detail:
 

SHA-1 certificate fingerprint
Copy the SHA-1 Fingerprint and paste it into Google Console.
Package name
Copy the Package name and paste into into Google Console.
 
Now hit Save to create the uniquely identified API key for Android applications.
ONCE A KEY IS GENERATED DO NOT REGENERATE A NEW KEY
 OR YOU WILL BREAK YOUR APP IN THE STORE!
 
FOR iOS

iOS does not require any Google setup as they use iOS maps for the device.
 
FOR HTML 5

You will need to enable Google Maps API v3 in the Google Developers Console.

You will then need to go to "Credentials in the Google Developers Console and "Create a New Key". Choose "Browser key". Then just tap "Create".

You can then take your new Key and copy the API Key into the EachScape builder: "Edit App/3rd Party/ Google Simple API key" and also put the same key in the EachScape builder: "'Edit App/3rd Party/Google Simple API key" for AdHoc .

ONCE A KEY IS GENERATED DO NOT REGENERATE A NEW KEY

OR YOU WILL BREAK YOUR APP IN THE STORE!