Distance Matrix

DistanceMatrixService クラス

google.maps.DistanceMatrixService クラス

複数の出発地と目的地の間の距離を計算するサービス。

const {DistanceMatrixService} = await google.maps.importLibrary("routes") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
DistanceMatrixService
DistanceMatrixService()
パラメータ: なし
距離行列のクエリを Google サーバーに送信する DistanceMatrixService の新しいインスタンスを作成します。
getDistanceMatrix
getDistanceMatrix(request[, callback])
パラメータ: 
戻り値:  Promise<DistanceMatrixResponse>
距離行列リクエストを発行します。

DistanceMatrixRequest インターフェース

google.maps.DistanceMatrixRequest インターフェース

DistanceMatrixService によって送信される距離行列クエリ。出発地と目的地の位置の配列と、指標を計算するためのさまざまなオプションが含まれます。
destinations
タイプ:  Array<string|LatLng|LatLngLiteral|Place>
目的地の住所文字列、LatLng、または Place オブジェクトを含む配列。目的地までの距離と時間の計算に使用されます。必須。
origins
タイプ:  Array<string|LatLng|LatLngLiteral|Place>
距離と時間の計算に使用する出発地の住所の文字列、LatLng、または Place オブジェクトを含む配列。必須。
travelMode
タイプ:  TravelMode
リクエストされたルーティングのタイプ。必須。
avoidFerries optional
タイプ:  boolean optional
true の場合、距離行列サービスに対し、できるだけフェリーを避けるように指示します。省略可。
avoidHighways optional
タイプ:  boolean optional
true の場合、距離行列サービスに対し、できるだけ高速道路を避けるように指示します。省略可。
avoidTolls optional
タイプ:  boolean optional
true の場合、可能な限り有料道路を避けるように距離行列サービスに指示します。省略可。
drivingOptions optional
タイプ:  DrivingOptions optional
travelMode が DRIVING のリクエストにのみ適用される設定。このオブジェクトは他の移動手段には影響しません。
language optional
タイプ:  string optional
結果を返す言語の言語識別子（可能な場合）。サポートされている言語の一覧をご覧ください。
region optional
タイプ:  string optional
ジオコーディング リクエストのバイアスとして使用される地域コード。地域コードは ccTLD（「トップレベル ドメイン」）の 2 文字の値で指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同じですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティです）です。
transitOptions optional
タイプ:  TransitOptions optional
travelMode が TRANSIT のリクエストにのみ適用される設定。このオブジェクトは他の移動手段には影響しません。
unitSystem optional
タイプ:  UnitSystem optional
距離を表示するときに使用する優先単位系。省略可能で、デフォルトはメートル法です。

DistanceMatrixResponse インターフェース

google.maps.DistanceMatrixResponse インターフェース

DistanceMatrixService リクエストに対するレスポンス。書式設定された出発地と目的地の住所、および対応する出発地の住所ごとに 1 つの DistanceMatrixResponseRow のシーケンスで構成されます。
destinationAddresses
タイプ:  Array<string>
書式設定した目的地の住所。
originAddresses
タイプ:  Array<string>
書式設定した出発地の住所。
rows
出発地の住所に対応する行列の行。

DistanceMatrixResponseRow インターフェース

google.maps.DistanceMatrixResponseRow インターフェース

DistanceMatrixService リクエストに対するレスポンスの行。対応する宛先アドレスごとに 1 つずつ、DistanceMatrixResponseElement のシーケンスで構成されます。
elements
目的地の住所に対応する行の要素。

DistanceMatrixResponseElement インターフェース

google.maps.DistanceMatrixResponseElement インターフェース

DistanceMatrixService リクエストに対するレスポンスの 1 つの要素。1 つの出発地から 1 つの目的地までの所要時間と距離が含まれます。
distance
タイプ:  Distance
この出発地と目的地のペアの距離。このプロパティは距離が不明な場合は未定義にできます。
duration
タイプ:  Duration
この出発地と目的地のペアの所要時間。このプロパティは所要時間が不明な場合は未定義にできます。
duration_in_traffic
タイプ:  Duration
この出発地と目的地のペアの所要時間。trafficModel プロパティで指定された交通状況を考慮します。所要時間が不明な場合があるため、このプロパティは undefined である場合があります。プレミアム プランをご利用のお客様は、リクエスト時に drivingOptions が定義されている場合にのみ利用できます。
fare
タイプ:  TransitFare
この出発地と目的地のペアの合計運賃。交通機関のリクエストにのみ適用されます。
status
この特定の出発地と目的地のペアのステータス。

DistanceMatrixStatus 定数

google.maps.DistanceMatrixStatus 定数

距離行列リクエストの完了時に DistanceMatrixService によって一般的に返される、リクエストに関するトップレベル ステータス。これらの値は、値または定数の名前で指定します。たとえば、'OK' や google.maps.DistanceMatrixStatus.OK などです。

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
INVALID_REQUEST 指定されたリクエストが無効です。
MAX_DIMENSIONS_EXCEEDED リクエストに 25 を超える出発地または 25 を超える目的地が含まれています。
MAX_ELEMENTS_EXCEEDED 出発地と目的地のサービスが、クエリごとの制限を超えました。
OK 有効な結果がレスポンスに含まれています。
OVER_QUERY_LIMIT 許可された期間内にリクエストされた要素が多すぎます。しばらくしてからもう一度試すと、リクエストが成功するはずです。
REQUEST_DENIED 距離行列サービスの使用がウェブページによって拒否されたことを示します。
UNKNOWN_ERROR サーバーエラーのため距離行列リクエストを処理できませんでした。再度リクエストすると、成功する可能性があります。

DistanceMatrixElementStatus 定数

google.maps.DistanceMatrixElementStatus 定数

距離行列リクエストの完了時に DistanceMatrixService によって返される特定の出発地と目的地のペアに関する要素レベルのステータス。これらの値は、文字列として指定します（例: 'OK'）。

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
NOT_FOUND このペアの出発地または目的地、あるいはその両方がジオコード化できませんでした。
OK 有効な結果がレスポンスに含まれています。
ZERO_RESULTS 出発地点と到着地点間でルートを見つけられませんでした。