Look Up a Location Service

You can look up a location service hosted on the HERE platform using one of these options:

• HERE platform portal user interface
• OLP Command Line interface (CLI)
• HERE Location Service Registry API

Through the HERE Platform Portal

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.