Powered by Zoomin Software. For more details please contactZoomin

HERE Geocoding and Search - Developer Guide

Product category
Technology
Doc type
Version
Product lifecycle
This publication

HERE Geocoding and Search - Developer Guide: Response enrichment with map references

Table of Contents

Response enrichment with map references

By using the request parameter showMapReferences, developers can enhance specific response items with map references, to enable connection with other services or data applications.

The following table lists currently supported values for showMapReferences:


Example of a /revgeocode response with showMapReferences=segments,links,pointAddress,adminIds,cmVersion:

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=52.518333,13.408333
    &types=address
    &lang=en-US
    &showMapReferences=segments,links,pointAddress,adminIds,cmVersion
    &apiKey={YOUR_API_KEY}
{
            "title": "Rathausstraße 15, 10178 Berlin, Germany",
            "id": "here:af:streetsection:2pGteqRk7Ros60IJL5KyEA:CgcIBCCk6s5QEAEaAjE1",
            "resultType": "houseNumber",
            "houseNumberType": "PA",
            "address": {
                "label": "Rathausstraße 15, 10178 Berlin, Germany",
                "countryCode": "DEU",
                "countryName": "Germany",
                "stateCode": "BE",
                "state": "Berlin",
                "countyCode": "B",
                "county": "Berlin",
                "city": "Berlin",
                "district": "Mitte",
                "street": "Rathausstraße",
                "postalCode": "10178",
                "houseNumber": "15"
            },
            "position": {"lat": 52.51856, "lng": 13.40821},
            "access": [{"lat": 52.51874, "lng": 13.40796}],
            "distance": 27,
            "mapView": {...},
            "mapReferences": {
                "links": [
                    {
                        "cmId": "733328455",
                        "side": "right"
                    }
                ],
                "pointAddress": {
                    "hmcId": "here:cm:pointaddress:169063716"
                },
                "segments": [
                    {
                        "ref": "here:cm:segment:783444988#0.481734",
                        "side": "left"
                    }
                ],
                "country": {
                    "hmcId": "here:cm:namedplace:20147700"
                },
                "state": {
                    "hmcId": "here:cm:namedplace:20187401"
                },
                "county": {
                    "hmcId": "here:cm:namedplace:20187402"
                },
                "city": {
                    "hmcId": "here:cm:namedplace:20187403"
                },
                "district": {
                    "hmcId": "here:cm:namedplace:20187417"
                },
                "cmVersion": {
                    "region": "WEU",
                    "dvn": "24121"
                }
            }
}

Note

  • linkId is deprecated and removed, it's replaced by cmId.
  • sideOfLink is deprecated and removed, it's replaced by side.
  • link.side and segment.side for the same entity are the same if the link direction aligns with the segment direction. However, they can differ if the link direction does not match the segment direction.
    • Forward link direction is defined as the direction from the reference node to the non-reference node. If latitude of reference node is smaller than non-reference node, the direction is from southernmost to northernmost. If latitude of both end nodes are identical and their longitudes differ, the direction is from westernmost node to easternmost node.
    • Forward segment direction is defined as the direction from the segment start node to the segment end node.
  • The previous parameter show=hmcReference is deprecated and replaced by showMapReferences=segments which serves the same purpose.

Was this article helpful?
TitleResults for “How to create a CRG?”Also Available inAlert