Places (Search) API Developer's Guide

Lookup Entrypoint

Endpoint provides ability to find a place by its foreign ID. Successful request results in redirect (HTTP status code 302) to the place resource with context added.

For more information how to retrieve foreign IDs, please see User Guide External References

The Lookup Entrypoint is a Places (Search) API Core entrypoint.

Entrypoint URI

/places/lookup

Entrypoint Parameters

Parameter Type Description
source String; required Name of the foreign ID source in lower case (e.g. pvid).
Supported values are:
  • pvid: Core POI
  • venues.content: Venue content ID
  • venues.destination: Venue destination ID
  • venues.venue: Venue ID
id String; required The ID of the requested place in foreign system.

GET Method

GET method provides lookup ability.

Request Example


https://places.cit.api.here.com/places/v1/places/lookup
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&source=pvid
&id=1115664033

Response Example

{ "href" : 
  "http://places.cit.api.here.com/places/v1/places/276u33dc-3944a4748a62499cb795cf8bee349c9c;context=Zmxvdy...
  ?app_id={YOUR_APP_ID}  
  &app_code={YOUR_APP_CODE}" 
}