Look Up a Location Service
You can look up a location service hosted on the HERE platform using one of these options:
In the HERE platform portal, the Services page lists all the location services to which you have access.
Through OLP CLI
As part of the HERE Data SDK, the OLP CLI offers a text-based interface and enables you to implement automated actions on platform services.
To look up a location service, first install the OLP CLI tool. Then, use the olp service list
command to list those location services to which you have access.
The command displays a list of location services in the console, as in the output below:
Available services:
name version HRN
Location Service Demo 1.0.0 hrn:here:service::olp-here:location-service-demo-1
Rendering - Vector Tiles 2.0.0 hrn:here:service::olp-here:rendering-vector-tiles-2
Routing 8.1.0 hrn:here:service::olp-here:routing-8
Routing - Intermodal 1.0.0 hrn:here:service::olp-here:routing-intermodal-1
Routing - Transit 1.0.0 hrn:here:service::olp-here:transit-routing-1
Search - Autosuggest 1.0.0 hrn:here:service::olp-here:search-autosuggest-1
Search - Browse 1.0.0 hrn:here:service::olp-here:search-browse-your-data-1
Search - Forward Geocoder 1.0.0 hrn:here:service::olp-here:search-forward-geocoder-1
Search - One Box Search 1.0.0 hrn:here:service::olp-here:search-one-box-search-1
Search - Places ID Lookup 1.0.0 hrn:here:service::olp-here:search-places-id-lookup-1
Search - Reverse Geocoder 1.0.0 hrn:here:service::olp-here:search-reverse-geocoder-1
Transit - Next Departures 1.0.0 hrn:here:service::olp-here:transit-next-departures-1
Transit - Station Search 1.0.0 hrn:here:service::olp-here:transit-station-search-1
To show the details of a specific location service by its HRN, including the service's base URL, use the olp service show <service HRN>
command.
If you use the olp service list
or olp service show
command in combination with the --json
option, the output contains data in the JSON format.
Example
To view the details of the Search - Autosuggest location service, run the following command:
olp service show hrn:here:service::olp-here:search-autosuggest-1 --json
As a result, the following JSON output appears in the console:
{
"owner": {
"creator": "zleyqcsxhjqlzuxzv9ms",
"organisation": "olp-here"
},
"summary": "Search - Autosuggest improves the user's experience by allowing the submittal of free-form, incomplete or miss-spelled addresses or place names. The results returned are a mixture of places or addresses relevant to the incomplete query, and complete Search - One Box Search query suggestions.",
"baseUrl": "https://autosuggest.search.hereapi.com/v1",
"protocol": "REST",
"hrn": "hrn:here:service::olp-here:search-autosuggest-1",
"created": "2019-08-08T10:27:49.25507Z",
"name": "Search - Autosuggest",
"state": "Running",
"dataSources": [{
"owner": "HERE",
"name": "HERE Map Content",
"description": "HERE Places & Addresses from HERE Map Content."
}],
"updated": "2020-03-31T16:36:51.814176Z",
"version": "1.0.0",
"tags": [
"HERE",
"Autosuggest",
"Search"
]
}
Through the HERE Location Service Registry API
Call the following endpoint to get a list of all active location services to which you have access:
curl https://registry.services.api.platform.here.com/v1/services \
-H "Authorization: Bearer <your access token>"
curl https://registry.services.api.platform.here.com/v1/services ^
-H "Authorization: Bearer <your access token>"
To retrieve the details for a specific location service by its HRN, use the following URL:
curl https://registry.services.api.platform.here.com/v1/services/{service HRN} \
-H "Authorization: Bearer <your access token>"
curl https://registry.services.api.platform.here.com/v1/services/{service HRN} ^
-H "Authorization: Bearer <your access token>"
For a sample output, see the example in the chapter above.