ルートを計算するには、少なくともルートの出発地と目的地の位置を指定する必要があります。これらの場所は、ルート上の地点として定義します。
出発地と目的地だけでなく、さまざまなタイプの地点と、ルートの地点の処理方法を指定できます。詳細と例については、次のトピックをご覧ください。
ルートのロケーションを指定する
ウェイポイント（REST）またはウェイポイント（gRPC）のオブジェクトを作成することで、ロケーションを表します。地点の定義では、次のいずれかの方法で場所を指定できます。
- Place ID（推奨）
- 緯度と経度の座標
- Address string（「Chicago, IL」、「Darwin, NT, Australia」）
- Plus Code
1 つのリクエストですべての地点に同じ方法で場所を指定することも、組み合わせることもできます。たとえば、出発地の地点には緯度と経度の座標を使用し、目的地の地点にはプレイス 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"
}
この例では、「Toledo」はスペインではなく、米国のオハイオ州の都市として解釈されます。したがって、リクエストは空の配列を返します。つまり、ルートが存在しないことを意味します。
{
[]
}
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 は、実際の住所がない人や場所の住所のようなものです。Plus Codes は、通りの名前や数字を含む住所ではなく、緯度と経度の座標に基づいて、数字と文字で表示されます。
Google が開発した Plus Codes は、あらゆる人が住所を活用できるようにするためです。Plus Code は、緯度/経度の座標から導出され、1/8, 000 度 1/8, 000 度（赤道では約 14 m x 14 m）以下の領域を表す、エンコードされた位置情報参照です。Plus Codes は、番地がない場所、建物に番号が付いていない場所、通りに名前がない場所では、番地の代わりに使用できます。
Plus Code は、グローバル コードまたは複合コードの形式にする必要があります。
- グローバル コードは、4 文字の市外局番と 6 文字以上のローカルコードで構成されます。
たとえば、住所が「1600 Amphitheatre Parkway, Mountain View, CA」の場合、グローバル コードは「849V」、ローカルコードは「CWC8+R9」です。次に、10 文字の Plus Code 全体を使用して、地域の値を「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 を特定できます。