ルートを計算するには、少なくともルートの出発地とルートの目的地の位置を指定する必要があります。これらの場所は、ルート上の経由地として定義します。
出発地と目的地に加えて、さまざまなタイプの経由地と、ルートの経由地の処理方法を指定できます。詳細と例については、次のトピックをご覧ください。
ルートの場所を指定する
位置は、Waypoint（REST）オブジェクトまたは Waypoint（gRPC）オブジェクトを作成して表します。経由地の定義では、次のいずれかの方法で位置を指定できます。
リクエスト内のすべての経由地の位置を同じ方法で指定することも、異なる方法で指定することもできます。たとえば、出発地の経由地には緯度と経度の座標を使用し、目的地の経由地にはプレイス ID を使用できます。
効率と精度を高めるため、緯度/経度座標や住所文字列ではなく、プレイス ID を使用します。プレイス ID は一意に明示的であり、アクセス ポイントや交通状況変数などのルーティングにジオコーディングのメリットをもたらします。これらは、他の方法でロケーションを指定した場合に発生する可能性のある次の状況を回避するのに役立ちます。
- 緯度/経度の座標を使用すると、その座標に最も近い道路に位置がスナップされることがあります。その道路が物件へのアクセス ポイントではない場合や、目的地に安全かつ迅速に到達できる道路ではない場合もあります。
- ルートを計算する前に、Routes API で住所文字列をジオコーディングして、緯度と経度の座標に変換する必要があります。この変換はパフォーマンスに影響する可能性があります。
場所をプレイス ID として指定する
プレイス ID を使用して、経由地の位置を指定できます。緯度と経度の座標は道路にスナップされるため、状況によってはプレイス ID の方がより良い結果が得られることがあります。
Geocoding API と Places API（Place Autocomplete を含む）からプレイス ID を取得します。プレイス ID について詳しくは、プレイス ID の概要をご覧ください。
次の例では、placeId プロパティを使用して、origin と destination の両方のプレイス ID を渡しています。
{ "origin":{ "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o" }, "destination":{ "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU" }, ... }
緯度と経度の座標で位置情報を指定する
地点のロケーションを定義するには、緯度/経度の座標を使用して Location（REST）または Location（gRPC）を指定します。
たとえば、latitude と longitude の座標を使用して、ルート origin と destination の経由地を指定します。
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, ... }
場所をアドレス文字列として指定する
アドレス文字列は、文字列で表されるリテラル アドレスです（例: 「1600 Amphitheatre Parkway, Mountain View, CA」）。ジオコーディングとは、住所文字列を緯度と経度の座標（緯度 37.423021、経度 -122.083739 など）に変換する処理のことです。
ウェイポイントの位置として住所文字列を渡すと、Routes API は内部で文字列をジオコーディングして、緯度と経度の座標に変換します。
たとえば、ルートを計算するには、アドレス文字列を使用してルート origin と destination の経由地を指定します。
{ "origin":{ "address": "1600 Amphitheatre Parkway, Mountain View, CA" }, "destination":{ "address": "450 Serra Mall, Stanford, CA 94305, USA" }, ... }
この例では、Routes API は両方の住所をジオコーディングして、緯度と経度の座標に変換します。
アドレス値が曖昧な場合、Routes API は検索を呼び出して、類似したアドレスから曖昧さを解消することがあります。たとえば、「1st Street」は、「1st street NE」や「1st St SE」の完全な値または部分的な値になります。この結果は、Geocoding API から返される結果とは異なる場合があります。プレイス ID を使用すると、誤解を招く可能性を回避できます。
住所の地域を設定する
不完全な住所文字列をウェイポイントの位置として渡すと、API が間違ったジオコードの緯度/経度座標を使用する可能性があります。たとえば、出発地を「トレド」、目的地を「マドリード」として、運転ルートのリクエストを行うとします。
{ "origin":{ "address": "Toledo" }, "destination":{ "address": "Madrid" }, "travelMode": "DRIVE" }
この例では、「トレド」はスペインではなく、米国のオハイオ州の都市として解釈されます。したがって、リクエストは空の配列を返します。これは、ルートが存在しないことを意味します。
{ [] }
regionCode パラメータを含めることで、特定の地域を優先して結果を返すように API を構成できます。このパラメータは、地域コードを ccTLD（「トップレベル ドメイン」）の 2 文字の値として指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。
regionCode パラメータを含む「トレド」から「マドリード」へのルート リクエストは、「トレド」がスペインの都市として解釈されるため、適切な結果を返します。
{ "origin":{ "address": "Toledo" }, "destination":{ "address": "Madrid" }, "travelMode": "DRIVE", "regionCode": "es" }
レスポンスに、スペインのトレドからスペインのマドリードまでのルートが計算されて含まれるようになりました。
{ "routes": [ { "distanceMeters": 75330, "duration": "4137s", ... } ] }
Plus Code で場所を指定する
多くの人が正確な住所がないために、配達物の受け取りが困難な場合があります。一方、住所がある人は裏口や発送センターなど、より特定の場所で配達物を受け取りたい場合があります。
Plus Codes は、実際の住所がない人や場所の番地のようなものです。番地と番地の番号を含む住所の代わりに、プラスコードは緯度と経度の座標に基づいており、数字と文字で表示されます。
Google は、すべての人や物に住所のメリットを提供するために、Plus Codes を開発しました。Plus Code はエンコードされた場所の参照情報です。緯度 / 経度の座標から取得され、8000 分の 1 x 8000 分の 1（14 メートル x 14 メートル）以下の領域を表します。Plus Codes は、番地がない場所や、建物に番号が付いていない場所、通りに名前がない場所で、番地の代わりに使用できます。
Plus Code は、グローバル コードまたは複合コードの形式にする必要があります。
- グローバル コードは、4 文字のエリアコードと 6 文字以上のローカルコードで構成されます。
たとえば、「1600 Amphitheatre Parkway, Mountain View, CA」という住所の場合、グローバル コードは「849V」、ローカル コードは「CWC8+R9」です。次に、10 文字のプラスコード全体を使用して、位置情報の値を「849VCWC8+R9」として指定します。
- 複合コードは、6 文字以上のローカルコードと明示的な場所を組み合わせたものです。
たとえば、「450 Serra Mall, Stanford, CA 94305, USA」という住所のローカルコードは「CRHJ+C3」です。複合住所の場合は、ローカルコードと住所の市区町村、都道府県、郵便番号、国を「CRHJ+C3 Stanford, CA 94305, USA」の形式で組み合わせます。
たとえば、Plus Codes を使用してルートの経由地
originとdestinationを指定してルートを計算します。{ "origin":{ "address": "849VCWC8+R9" }, "destination":{ "address": "CRHJ+C3 Stanford, CA 94305, USA" }, "travelMode": "DRIVE" }
Plus Codes は、Place Autocomplete、Place Details、Directions API（以前のバージョン）、Geocoding API などの Google Maps Platform API でサポートされています。たとえば、Geocoding API を使用して、緯度と経度の座標で指定された位置をリバース ジオコーディングし、その位置の Plus Code を特定できます。