ナビゲーション属性を使用したレスポンスの強化

リクエストパラメーターshowNavAttributesを使用すると、ディベロッパーはナビゲーション属性を使用して特定のレスポンス項目を強化できます。

現在 showNavAttributes でサポートされている値は次の表のとおりです。

`showNavAttributes` 値	エンドポイント	成熟度および特権	説明
`functionalClass`	`/geocode`、`/revgeocode`、`/multi-revgeocode`、`/lookup`	GA	`resultType=houseNumber` または `resultType=street` の結果項目の場合、結果のアクセス位置がある一般道路の機能クラスを示す値を返します。詳細については、API リファレンスを参照してください。
`access`	`/geocode`、`/revgeocode`、`/multi-revgeocode`、`/lookup`	GA	`resultType=houseNumber` または `resultType=street` の結果項目の場合、結果のアクセス位置がある一般道路で許可されている車タイプを示す値を返します。詳細については、API リファレンスを参照してください。
`physical`	`/geocode`、`/revgeocode`、`/multi-revgeocode`、`/lookup`	GA	`resultType=houseNumber` または `resultType=street` の結果項目の場合、結果のアクセス位置がある一般道路の特殊な物理的特性を示す値を返します。詳細については、API リファレンスを参照してください。
`speedLimits`	`/geocode`、`/revgeocode`、`/multi-revgeocode`、`/lookup`	GA	`resultType=houseNumber` または `resultType=street` の結果項目の場合、結果のアクセス位置がある道路の速度制限と移動方向を返します。詳細については、API リファレンスを参照してください。注：制限速度機能の価格については、「HERE基本プランの価格表」を参照してください。価格についてご質問がある場合は、お問い合わせください。

showNavAttributes=functionalClass,access,phyical,speedLimitsを使用した/revgeocodeエンドポイントレスポンスの例：

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
                  }
              ]
          }
      }
  ]
}

📘
注
この機能は現在日本ではサポートされていません。