Venue Maps API Developer's Guide

Signature Service

Signature Service Requests

The Signature Service returns the credentials that are necessary to construct signed requests to Venue Maps API. Each signature is valid for 24 hours. Once your signature expires, you must request a new set of credentials.

Table 1. Basic elements of request to Signature Service
Element	Value/Example	Description
Base	`http://signature.venue.maps.api.here.com`	Production 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.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.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"
}}