HERE Maps & Location Services

Technical Guide
Version 8.0.0.0
HERE Maps & Location Services Technical Guide
►

Important Information
Notices
Topics:

• Legal Notices
• Document Information

2
HERE Maps & Location Services Technical Guide
► Notices

Legal Notices

3
HERE Maps & Location Services Technical Guide
► Notices

Document Information

Product
Name: HERE Location Services Serverless Functions Technical Guide
Version: Version 8.0.0.0

Document
Name: HERE Location Services Serverless Functions Technical Guide
Status: FINAL
Date: 2019-Apr-09, 12:00 (GMT)

4
HERE Maps & Location Services Technical Guide
►

Contents
Notices ............................................................................................................................................................... 2
Legal Notices ..................................................................................................................................................... 3
Document Information ................................................................................................................................. 4
Contents ............................................................................................................................................................ 5
Overview ........................................................................................................................................................... 6
Introduction ........................................................................................................................................................7
Solution Template Overview .......................................................................................................................7
Technical Guide ..............................................................................................................................................9
Acquiring HERE API Key............................................................................................................................... 10
Technical Guide for using Solution Template on Azure Portal ............................................... 10
Examples: .......................................................................................................................................................... 13

5
HERE Maps & Location Services Technical Guide
► Overview

Chapter 1
Overview
This document introduces the technical steps for
Topics: HERE Maps & Location Services Serverless
Functions on Azure Marketplace. The HERE
• Introduction Location Services Serverless Functions is a
• Solution Template Overview Solution Template on Azure Marketplace which
deploys the HERE Maps & Location Services
Serverless Functions into your resources.

6
HERE Maps & Location Services Technical Guide
► Overview

Introduction
HERE Maps and Location Services Serverless Functions bring enterprise-grade, SLA backed
location services to Azure applications. HERE Maps and location services solve a range of
problems from map visualization, navigation and routing, geocoding, time zone look ups to
geofencing, custom locations and routing, route matching GPS traces, geospatial, sequencing
multiple waypoints, truck routing, positioning, etc.

Solution Template Overview

HERE Maps & Location Services Serverless Functions deploys HERE's enterprise class SLA
backed Maps & Location Services for all your Azure Applications.
These services address a range of use cases like Fleet Utilization, Supply Chain Optimization,
Urban Movement, etc., and open up new location intelligence opportunities in diverse
industries like Automotive, Insurance, Internet and Media, Mobile Payments, Public Sector
and Infrastructure, Telecom and Utilities, and Transportation and Logistics.

The function app in this ARM Template consists of the following HERE Location Service APIs:
Geocoding and Search
• Geocoder: Forward and Reverse
• Batch Geocoder
• Geocoder Autocomplete
• Places
Maps
• Map Image
• Map Tile
Navigation and Routing
• Routing - Mode (car, truck, public transit, bicycle) and algorithm (matrix, isoline
routing)
• Public Transit
Fleet Telematics
• Considering toll costs along a route
• Working with geofences
• Working with custom locations
• Building custom routes
• Integrating advanced HERE data sets
• Route matching GPS traces
• Calculating an optimal sequence of waypoints
More APIs
• Positioning - Provides positioning estimates based on global Wi-Fi and Cell
coverage, which includes the latitude and longitude of the position with accuracy.

7
HERE Maps & Location Services Technical Guide
► Overview

Architecture of HERE Maps & Location Services:

8
HERE Maps & Location Services Technical Guide
► Technical Guide

Chapter 2
Technical Guide

Topics:

• Acquiring HERE API Key

• Technical Guide for using Solution Template on Azure Portal

9
HERE Maps & Location Services Technical Guide
► Technical Guide

Acquiring HERE API Key

All users of HERE APIs must obtain authentication and authorization credentials and provide
them as values for the parameter HERE API Key in the HERE Credentials section in Azure’s
template deployment page.

To obtain the credentials for the deployment of HERE Maps & Location Services Serverless
Functions, please visit https://developer.here.com to register for FREE with HERE.

Technical Guide for using Solution Template on Azure Portal

HERE Azure HTTP Functions are available as REST endpoints and are in specific format.
Customers can choose “Function App Name” as part of deployment which builds a globally
unique URL in format of https://<UniqeAppName>.azurewebsites.net

Each HTTP function maps to a REST API out of listed 7 APIs, availability of these will end in
URL as below

S. N.. API Name Azure HTTP Function URL

1 Geocoder https://<UniqeAppName>.azurewebsites.net/api/geocoder/

2 Routing https:// <UniqeAppName>.azurewebsites.net/api/routing/

3 Positioning https://<UniqeAppName>.azurewebsites.net/api/positioning/
https://<UniqeAppName>.azurewebsites.net/api/map_image/
4 Map Image

5 Map Tiles https://<UniqeAppName>.azurewebsites.net/api/map_tile/

6 Fleet Telematics https://<UniqeAppName>.azurewebsites.net/api/fleet/

7 Public Transit https://<UniqeAppName>.azurewebsites.net/api/public_transit/

10
HERE Maps & Location Services Technical Guide
►

HERE REST API URL maps with Azure Function URL as below:

S. API Name HERE URL Azure HTTP Function URL

N.

1 Geocoder https://discover.search.he https://<UniqeAppName>.azurewebsites.ne

reapi.com/ t/api/geocoder/v1/discover

https://geocode.search.he https://<UniqeAppName>.azurewebsites.ne
reapi.com/ t/api/geocoder/v1/geocode

https://autosuggest.searc https://<UniqeAppName>.azurewebsites.ne
h.hereapi.com/ t/api/geocoder/v1/autosuggest

https://browse.search.her https://<UniqeAppName>.azurewebsites.ne
eapi.com/ t/api/geocoder/v1/browse

https://lookup.search.her https://<UniqeAppName>.azurewebsites.ne
eapi.com/ t/api/geocoder/v1/lookup

https://revgeocode.search https://<UniqeAppName>.azurewebsites.ne
.hereapi.com/ t/api/geocoder/v1/revgeocode

2 Routing https://router.hereapi.co https://

m/ <UniqeAppName>.azurewebsites.net/api/ro
uting/
https://isoline.route.ls.her
eapi.com/ https://
<UniqeAppName>.azurewebsites.net/api/ro
https://matrix.route.ls.her uting/isoline.route/
eapi.com/
https://
<UniqeAppName>.azurewebsites.net/api/ro
uting/matrix.route/

3 Positioning https://pos.ls.hereapi.com https://<UniqeAppName>.azurewebsites.ne

/positioning/ t/api/positioning/
https://image.ls.hereapi.c https://<UniqeAppName>.azurewebsites.ne
4 Map Image om/ t/api/map_image/

5 Map Tiles https://{1- https://<UniqeAppName>.azurewebsites.ne

4}.aerial.maps.ls.hereapi.c t/api/map_tile/
om/

11
 https://{1-
4}.base.maps.ls.hereapi.co
m/

https://{1-
4}.traffic.maps.ls.hereapi.c
om/

6 Fleet https://fleet.ls.hereapi.co https://<UniqeAppName>.azurewebsites.ne

Telematics m/ t/api/fleet/
https://transit.hereapi.co
7 Public m/v8/ https://<UniqeAppName>.azurewebsites.ne
Transit t/api/public_transit/departures

https://<UniqeAppName>.azurewebsites.ne
t/api/public_transit/stations

https://<UniqeAppName>.azurewebsites.ne
t/api/public_transit/routes

12
HERE Maps & Location Services Technical Guide
►

Azure serverless functions are protected at function level and need an extra parameter to
authenticate. Please refer below link for more details. https://docs.microsoft.com/en-
us/azure/azure-functions/functions-bindings-http-webhook#authorization-keys

Examples:

Let’s assume our azure function-app is running as https://funcapp4hls.azurewebsites.net

Sample HERE API Key: {HERE_API_KEY}
Sample FunctionAccessCode :
iAcAWqx78cA3b2heZnaFHjMHbYC0/I/JcO7zyDM3FyfA6fjHM2BeSw====

Geocoder :
HERE URL : https://geocode.search.hereapi.com/v1/geocode?apikey={HERE_API_KEY}&q=5
Rue Daunou, 75000 Paris, France

HERE URL part Azure URL part (translated)

https://geocode.search.hereapi.c https://<UniqeAppName>.azurewebsites.net/api/geoco
om der/
apikey={HERE_API_KEY} Not required
/v1/geocode?q=5 Rue Daunou, As is (no change)
75000 Paris, France

code=<function-access-key> New addition in the URL

Translated URL will look like:

https://funcapp4hls.azurewebsites.net/api/geocoder/v1/geocode?q=5 Rue Daunou, 75000
Paris, France&code=iAcAWqx78cA3b2heZnaFHjMHbYC0/I/JcO7zyDM3FyfA6fjHM2BeSw====

13
HERE Maps & Location Services Technical Guide
► Technical Guide
Few more examples as below to show the mappings:
API Name HERE API URL
https://geocode.search.here
api.com/v1/geocode?apikey=
{HERE_API_KEY}&q=5 Rue
Daunou, 75000 Paris, France
Geocoder
https://geocode.search.here
api.com/v1/geocode?apikey=
{HERE_API_KEY}&searchtext=2
00%20S%20Mathilda%20Sun
nyvale%20CA&locationattribu
tes=none&responseattribute
s=none&gen=9
https://reverse.geocoder.api.
Reverse - here.com/v1/revgeocode?
Geocoder apikey={HERE_API_KEY}&at=4
8.2181679%2C16.3899064&lan
g=en-US
https://revgeocode.search.he
re.com/v1/revgeocode?
apikey={HERE_API_KEY}&mod
e=retrieveLandmarks&prox=3
7.7442,-119.5931,1000
https://router.hereapi.com/r
outing/v8/calculatematrix.js
on?apikey={HERE_API_KEY}&
mode=fastest%3Bpedestrian
&start=52.5160%2C13.3778&ra
ngetype=distance&range=200
0
https://router.hereapi.com/r
Routing
outing/v8/routes?apikey={HE
RE_API_KEY}&transportMode
=car&origin=52.5308,13.3847&
destination=52.5323,13.3789&r
eturn=summary
Azure HTTP Function URL
https://funcapp4hls.azurewebsites.net/api/g
eocoder/v1/geocode?q=5 Rue Daunou, 75000
Paris, France
&code=iAcAWqx78cA3b2heZnaFHjMHbYC0/I/J
cO7zyDM3FyfA6fjHM2BeSw====
https://funcapp4hls.azurewebsites.net/api/g
eocoder/v1/geocode?searchtext=200%20S%2
0Mathilda%20Sunnyvale%20CA&locationattri
butes=none&responseattributes=none&gen=
9&code=iAcAWqx78cA3b2heZnaFHjMHbYC0/I
/JcO7zyDM3FyfA6fjHM2BeSw====
https://funcapp4hls.azurewebsites.net/api/g
eocoder/v1/revgeocode?at=48.2181679%2C16.
3899064&lang=en-
US&code=iAcAWqx78cA3b2heZnaFHjMHbYC0/
I/JcO7zyDM3FyfA6fjHM2BeSw====
https://funcapp4hls.azurewebsites.net/api/g
eocoder/v1/revgeocode?mode=retrieveLand
marks&prox=37.7442,-
119.5931,1000&code=iAcAWqx78cA3b2heZnaF
HjMHbYC0/I/JcO7zyDM3FyfA6fjHM2BeSw====
https://funcapp4hls.azurewebsites.net/api/r
outing/7.2/calculateisoline.json?mode=fastes
t%3Bpedestrian&start=52.5160%2C13.3778&ra
ngetype=distance&range=2000&code=iAcAW
qx78cA3b2heZnaFHjMHbYC0/I/JcO7zyDM3FyfA
6fjHM2BeSw====
https://funcapp4hls.azurewebsites.net/api/r
outing/v8/routes/?transportMode=car&origi
n=52.5308,13.3847&destination=52.5323,13.378
9&return=summary&code=<fncode>&code=i
AcAWqx78cA3b2heZnaFHjMHbYC0/I/JcO7zyD
M3FyfA6fjHM2BeSw====
14
https://matrix.route.ls.herea
pi.com/routing/7.2/calculate
matrix.json?apikey={HERE_AP
I_KEY}calculatematrix.json?m
ode=fastest%3Btruck%3Btraff
ic%3Adisabled%3B&start0=40
.7790%2C-
73.9622&destination0=40.748
2%2C-
73.9860&destination1=40.7558
%2C-
73.9870&destination2=40.7054
%2C-73.9961
https://funcapp4hls.azurewebsites.net/api/r
outing/7.2/calculatematrix.json?mode=fastes
t%3Btruck%3Btraffic%3Adisabled%3B&start0
=40.7790%2C-
73.9622&destination0=40.7482%2C-
73.9860&destination1=40.7558%2C-
73.9870&destination2=40.7054%2C-
73.9961&code=iAcAWqx78cA3b2heZnaFHjMHb
YC0/I/JcO7zyDM3FyfA6fjHM2BeSw====
15