ジオコーディング レスポンス内の navigation_points フィールドには、場所への移動に役立つポイントのリストが含まれています。具体的には、場所から場所への道路網での経路検索の始点または終点として使用する必要があります。各ナビゲーション ポイントには次の値が含まれます。
locationには、ナビゲーション ポイントの緯度と経度の値が含まれます。この場所は常に道路網のすぐ近くにあり、場所への移動や場所からの移動の理想的な出発地または目的地となります。このポイントは、道路の中心線から意図的にわずかにずらして、場所がある道路の側を明確に示しています。restricted_travel_modesは、ナビゲーション ポイントにアクセスできない移動手段のリストです。"DRIVE"は、運転ルートに対応する交通手段です。"WALK"は、徒歩経路に対応する移動手段です。road_nameには、ナビゲーション ポイントがオフセットされる道路の名前が格納されます。
ナビゲーション ポイントは、住所、建物、施設など、正確な位置情報を持つほとんどの場所で返されます。都市や地域など、正確な位置が曖昧になる可能性のある広い地域を表す場所では、ナビゲーション ポイントが返されないことがあります。
移行のお知らせ
4 月 17 日より、ナビゲーション ポイントを受け取るには、リクエストで NAVIGATION_POINTS 追加の計算パラメータを指定する必要があります。クライアントは、一部のナビゲーション ポイント内の 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 までお寄せください。