このページは Cloud Translation API によって翻訳されました。

ナビゲーションポイント

ジオコーディングレスポンスの navigation_points フィールドには、場所へのナビゲーションに役立つポイントのリストが含まれています。具体的には、道路網で場所から場所へのルーティングを行う際に、始点または終点として使用する必要があります。各ナビゲーションポイントには次の値が含まれます。

location には、ナビゲーションポイントの緯度と経度の値が含まれます。この場所は常に道路網に非常に近く、場所との行き来に最適な停留所または出発地を表します。ポイントは道路の中心線から意図的に少しずらして配置され、場所が道路のどちら側にあるかを明確に示しています。
restricted_travel_modes は、ナビゲーションポイントからアクセスできない移動手段のリストです。

"DRIVE" は、運転ルートに該当する移動モードです。
"WALK" は、徒歩経路に対応する移動モードです。

road_name には、ナビゲーションポイントがオフセットされている道路の名前が格納されます。

正確な位置情報を持つほとんどの場所（住所、建物、施設など）に対して、ナビゲーションポイントが返されます。都市や地域など、広範囲を表すプレイスでは、正確な位置が不明確なため、ナビゲーションポイントが返されないことがあります。

移行に関するお知らせ

4 月 17 日より、ナビゲーションポイントを受け取るには、リクエストで NAVIGATION_POINTS extra computations パラメータを指定する必要があります。クライアントは、一部のナビゲーションポイント内の road_name フィールドが返され、各ナビゲーションポイント内の location フィールドに次の 4 つのサブフィールド（lat、lng、latitude、longitude）があることを確認することで、これをテストできます。

また、location.latitude フィールドと location.longitude フィールドではなく、location.lat フィールドと location.lng フィールドに移行する必要があります。今後のリリースでは、NAVIGATION_POINTS 追加計算パラメータが含まれていないリクエストには、レスポンスにナビゲーションポイントが含まれず、location.latitude フィールドと location.longitude フィールドが返されなくなります。

リクエストの詳細

ナビゲーションポイントは、次の種類のリクエストで取得できます。

これらのリクエストでは、extra_computations=NAVIGATION_POINTS というパラメータを指定します。

リクエスト例

次のクエリでは、場所のジオコーディングを使用して、米国カリフォルニア州マウンテンビューにあるレストランのナビゲーションポイントを取得します。

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

レスポンスの例

上記のクエリからのレスポンスには、ナビゲーションポイントの配列が表示されます。

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

フィードバック

この機能は試験運用中です。フィードバックは geocoding-feedback-channel@google.com までお寄せください。

ナビゲーション ポイント