Response enrichment with navigation attributes
By using the request parameter showNavAttributes, developers can enhance specific response items with navigation attributes.
The following table lists currently supported values for showNavAttributes:
showNavAttributes value | endpoints | maturity privilege | Description |
|---|---|---|---|
functionalClass | /geocode, /revgeocode, /multi-revgeocode, /lookup | GA | For resultType=houseNumber or resultType=street result item, returns the value that describes the functional class of the road where the result access position is located. For more details, see the API Reference. |
access | /geocode, /revgeocode, /multi-revgeocode, /lookup | GA | For resultType=houseNumber or resultType=street result item, returns the values that describe the allowed vehicle types of the road where the result access postion is located. For more details, see the API Reference. |
physical | /geocode, /revgeocode, /multi-revgeocode, /lookup | GA | For resultType=houseNumber or resultType=street result item, returns the values that describe the special physical characteristics of the road where the result access position is located. For more details, see the API Reference. |
speedLimits | /geocode, /revgeocode, /multi-revgeocode, /lookup | GA | For resultType=houseNumber or resultType=street result item, returns the speed limits and travel directions of the road where the result access position is located. For more details, see the API Reference. Note: For information about the pricing of the speed limits feature, see the HERE Base Plan Pricing. If you have questions about pricing, contact us. |
Example of a /revgeocode endpoint response with showNavAttributes=functionalClass,access,phyical,speedLimits:
GET https://revgeocode.search.hereapi.com/v1/
revgeocode
?at=37.7702656,-122.4213821
&showNavAttributes=functionalClass,access,physical,speedLimits
&apiKey={YOUR_API_KEY}{
"items": [
{
"title": "Central Fwy, San Francisco, CA 94103, United States",
"id": "here:af:streetsection:-A9JAiubJC1FVMNNWl3OJB",
"resultType": "street",
"address": {
"label": "Central Fwy, San Francisco, CA 94103, United States",
"countryCode": "USA",
"countryName": "United States",
"stateCode": "CA",
"state": "California",
"county": "San Francisco",
"city": "San Francisco",
"district": "Soma",
"street": "Central Fwy",
"postalCode": "94103"
},
"position": {"lat": 37.77026, "lng": -122.42138},
"distance": 1,
"mapView": {...},
"navigationAttributes": {
"speedLimits": [
{
"maxSpeed": 50,
"direction": "NW",
"speedUnit": "mph",
"source": "posted"
}
],
"functionalClass": [
{
"value": "3"
}
],
"access": [
{
"automobiles": true,
"bicycles": false,
"buses": true,
"carpools": true,
"deliveries": true,
"emergencyVehicles": true,
"motorcycles": true,
"pedestrians": false,
"taxis": true,
"throughTraffic": true,
"trucks": true
}
],
"physical": [
{
"boatFerry": false,
"bridge": true,
"deliveryRoad": false,
"movableBridge": false,
"multiplyDigitized": true,
"paved": true,
"private": false,
"railFerry": false,
"tunnel": false
}
]
}
}
]
}Note
The feature is not currently supported in Japan.
Updated last month