Venue Maps API Developer's Guide

Signature Service

Signature Service Request

The Signature Service returns credentials necessary to construct signed requests to Venue Maps API.

Table 1. Basic elements of request to Signature Service
Element Value/Example Description
Base

http://signature.venue.maps.api.here.com

http://signature.venue.maps.cit.api.here.com

Production environment

Customer Integration Testing environment

Service venues
Feature signature
Version v1 Version number of Venue Maps API
Application Id app_id={YOUR_APP_ID} Substitute with your unique Application Id
Application Code app_code={YOUR_APP_CODE} Substitute with your unique Application Code
JSONP static callback function (optional) cbfn=JSON.venues Substitute with desired static callback URL encoded

Examples

Example request:


http://signature.venue.maps.cit.api.here.com/venues/signature/v1
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}

Example request (with static callback):

http://signature.venue.maps.cit.api.here.com/venues/signature/v1
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &cbfn=JSON.venues

Signature Service Response

Attributes

Attribute Type Description
app_id String Verified Application Id
app_code String Verified Application Code
Signature String Venue Maps API signed request parameter
Policy String Venue Maps API signed request parameter
Key-Pair-Id String Venue Maps API signed request parameter

Example response of Signature Service

{"status":
  {"code":"200","message":"OK"},
  "Hostname":"ip-10-96-40-53.eu-west-1.compute.internal",
  "SignedQueryString":"?Policy\u003deyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6Imh0dHAqOi8vc3RhdGljLSoudmVudWUubWFwcy5jaXQuYXBpLmhlcmUuY29tLyo~YXBwX2lkPURlbW9BcHBJZDAxMDgyMDEzR0FMJmFwcF9jb2RlPUFKS25Ydjg0ZmpyYjBLSUhhd1MwVGciLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE0NTUyNzIxNDR9LCJJcEFkZHJlc3MiOnsiQVdTOlNvdXJjZUlwIjoiMC4wLjAuMC8wIn0sIkRhdGVHcmVhdGVyVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxMzkyMjAwMTQ0fX19XX0_\u0026Signature\u003dCEM8ouuwEB50pHwdDgiEqCQeotCUGfz2l1EX~wkFx2FUeou~kCabtlvI5pA5CNSxpkfPriYMdmovctNtPEVebKeBTiMpq8cmVj-ljPkTsZPm-Bnlp8MVP3mWHgOtA0PiFjouXIvfCqbGpzXN0V3mrHk150-s5z6ApN0RdmnQPB5Ac3tHrF7K77Cr6FO841a6437Mul-JIyEivzB-0n03mAvXlQ2KtIej0Nukh3SOJ93Q4OTMrnto09oSXwZ1JMIFQR5LkFadvW3~a4a7w6nPyabJGIKh2OIt~MixLwBelb1362X6oyVgnVNtcqENI-szzDQDsvBFUQh-TsvQReivrw__\u0026Key-Pair-Id\u003dAPKAJYHWIIHIUVYKYWZA\u0026app_id\u003d{YOUR_APP_ID}\u0026app_code\u003d{YOUR_APP_CODE}",
  "Expires":"2016-02-12T10:15:44Z",
  "SignatureTokens"{

"app_id":"{YOUR_APP_ID}",
"app_code":"{YOUR_APP_CODE}",
    "Signature":"CEM8ouuwEB50pHwdDgiEqCQeotCUGfz2l1EX~wkFx2FUeou~kCabtlvI5pA5CNSxpkfPriYMdmovctNtPEVebKeBTiMpq8cmVj-ljPkTsZPm-Bnlp8MVP3mWHgOtA0PiFjouXIvfCqbGpzXN0V3mrHk150-s5z6ApN0RdmnQPB5Ac3tHrF7K77Cr6FO841a6437Mul-JIyEivzB-0n03mAvXlQ2KtIej0Nukh3SOJ93Q4OTMrnto09oSXwZ1JMIFQR5LkFadvW3~a4a7w6nPyabJGIKh2OIt~MixLwBelb1362X6oyVgnVNtcqENI-szzDQDsvBFUQh-TsvQReivrw__",
      "Policy":"eyJTdGF0ZW1lbnQiOiBbeyJSZXNvdXJjZSI6Imh0dHAqOi8vc3RhdGljLSoudmVudWUubWFwcy5jaXQuYXBpLmhlcmUuY29tLyo~YXBwX2lkPURlbW9BcHBJZDAxMDgyMDEzR0FMJmFwcF9jb2RlPUFKS25Ydjg0ZmpyYjBLSUhhd1MwVGciLCJDb25kaXRpb24iOnsiRGF0ZUxlc3NUaGFuIjp7IkFXUzpFcG9jaFRpbWUiOjE0NTUyNzIxNDR9LCJJcEFkZHJlc3MiOnsiQVdTOlNvdXJjZUlwIjoiMC4wLjAuMC8wIn0sIkRhdGVHcmVhdGVyVGhhbiI6eyJBV1M6RXBvY2hUaW1lIjoxMzkyMjAwMTQ0fX19XX0_",

"Key-Pair-Id":"APKAJYHWIIHIUVYKYWZA"
}}

Example response of Signature Tokens

"SignatureTokens": {
  "app_id": "{YOUR_APP_ID}",
  "app_code": "{YOUR_APP_CODE}",
  "Signature": "<Signature-value>",
  "Policy": "<Policy-value>",
  "Key-Pair-Id": "<Key-Pair-Id-value>"
}