DirectionsService クラス
google.maps.DirectionsService
クラス
2 つ以上の地点間のルートを計算するサービスです。
const {DirectionsService} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
DirectionsService |
DirectionsService() パラメータ: なし
Google サーバーにルート検索クエリを送信する DirectionsService の新しいインスタンスを作成します。 |
メソッド | |
---|---|
route |
route(request[, callback]) パラメータ:
戻り値:
Promise<DirectionsResult> ルート検索リクエストを発行します。 |
DirectionsRequest インターフェース
google.maps.DirectionsRequest
インターフェース
DirectionsService
に送信される経路クエリ。
プロパティ | |
---|---|
destination |
タイプ:
string|LatLng|Place|LatLngLiteral 目的地の場所。これは、ジオコーディングされる文字列、 LatLng 、または Place として指定できます。必須。 |
origin |
タイプ:
string|LatLng|Place|LatLngLiteral 原産地。これは、ジオコーディングされる文字列、 LatLng 、または Place として指定できます。必須。 |
travelMode |
タイプ:
TravelMode リクエストされたルーティングのタイプ。必須。 |
avoidFerries optional |
タイプ:
boolean optional true の場合、ルート サービスに、可能であればフェリーを避けるよう指示します。省略可。 |
avoidHighways optional |
タイプ:
boolean optional true の場合、ルート サービスに、可能な限り高速道路を避けるよう指示します。省略可。 |
avoidTolls optional |
タイプ:
boolean optional true の場合、Directions サービスに、可能な限り有料道路を避けるよう指示します。省略可。 |
drivingOptions optional |
タイプ:
DrivingOptions optional travelMode が DRIVING のリクエストにのみ適用される設定。このオブジェクトは、他の移動手段には影響しません。 |
language optional |
タイプ:
string optional 可能な場合、結果を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。 |
optimizeWaypoints optional |
タイプ:
boolean optional true に設定されている場合、DirectionsService は指定された中間地点を並べ替えて、ルートの全体的な費用を最小限に抑えようとします。地点が最適化されている場合は、レスポンスの DirectionsRoute.waypoint_order を調べて新しい順序を確認します。 |
provideRouteAlternatives optional |
タイプ:
boolean 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 デフォルト: 出発地の国で使用されている単位系。
距離を表示する際に使用される、優先単位系。 |
waypoints optional |
タイプ:
Array<DirectionsWaypoint> optional 中間ウェイポイントの配列。この配列の各経由地を経由して、出発地から目的地までのルートが計算されます。使用できる地点の最大数については、 デベロッパー ガイドをご覧ください。地点は乗換案内では利用できません。省略可。 |
DirectionsStatus 定数
google.maps.DirectionsStatus
定数
route()
の呼び出しの完了時に DirectionsService
によって返されるステータス。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'OK'
や google.maps.DirectionsStatus.OK
です。
const {DirectionsStatus} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
INVALID_REQUEST |
指定された DirectionsRequest が無効です。 |
MAX_WAYPOINTS_EXCEEDED |
DirectionsRequest で指定された DirectionsWaypoint が多すぎます。使用できる地点の最大数については、 デベロッパー ガイドをご覧ください。 |
NOT_FOUND |
出発地点、到着地点、ウェイポイントのうち、少なくとも 1 つがジオコード化できませんでした。 |
OK |
レスポンスには有効な DirectionsResult が含まれています。 |
OVER_QUERY_LIMIT |
ウェブページは、短期間にリクエストの制限回数を超えました。 |
REQUEST_DENIED |
ウェブページでルート サービスを使用できません。 |
UNKNOWN_ERROR |
サーバーエラーが原因でルート リクエストを処理できなかったことを示します。もう一度試すと正常に処理される可能性があります。 |
ZERO_RESULTS |
出発地点と到着地点間でルートを見つけられませんでした。 |
DirectionsResult インターフェース
google.maps.DirectionsResult
インターフェース
ルート サーバーから取得したルート レスポンス。これらは DirectionsRenderer
を使用してレンダリングすることも、このオブジェクトを解析して自分でレンダリングすることもできます。Google Maps Platform 利用規約に記載されているとおり、警告と著作権を表示する必要があります。この結果は「JSON のような」ものですが、LatLng
オブジェクトを間接的に含んでいるため、厳密には JSON ではありません。
プロパティ | |
---|---|
request |
タイプ:
DirectionsRequest この結果を生成した DirectionsRequest。 |
routes |
タイプ:
Array<DirectionsRoute> DirectionsRoute の配列。各 DirectionsRoute には、構成される区間とステップに関する情報が含まれています。DirectionsRequest が provideRouteAlternatives を true に設定して作成された場合を除き、ルートは 1 つだけです。 |
available_travel_modes optional |
タイプ:
Array<TravelMode> optional 利用可能な移動手段の配列が含まれます。このフィールドは、リクエストで移動手段が指定され、結果が返されなかった場合に返されます。この配列には、指定された地点セットの国で使用可能な交通手段が含まれます。1 つ以上の経由地点がある場合、このフィールドは返されません。 |
geocoded_waypoints optional |
タイプ:
Array<DirectionsGeocodedWaypoint> optional DirectionsGeocodedWaypoint の配列。各 DirectionsGeocodedWaypoint には、出発地、目的地、地点のジオコーディングに関する情報が含まれています。 |
DirectionsRenderer クラス
google.maps.DirectionsRenderer
クラス
DirectionsService
から取得したルートをレンダリングします。
このクラスは MVCObject
を拡張します。
const {DirectionsRenderer} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) パラメータ:
指定されたオプションでレンダラを作成します。ルートは地図上に(ビジュアル オーバーレイとして)レンダリングできます。また、 <div> パネル上にも(テキストによる指示として)レンダリングできます。 |
メソッド | |
---|---|
getDirections |
getDirections() パラメータ: なし
戻り値:
DirectionsResult レンダラの現在のルートのセットを返します。 |
getMap |
getMap() パラメータ: なし
戻り値:
Map DirectionsResult がレンダリングされるマップを返します。 |
getPanel |
getPanel() パラメータ: なし
戻り値:
HTMLElement|null DirectionsResult がレンダリングされるパネル <div> を返します。 |
getRouteIndex |
getRouteIndex() パラメータ: なし
戻り値:
number この DirectionsRenderer オブジェクトで使用されている現在の(ゼロベースの)ルート インデックスを返します。 |
setDirections |
setDirections(directions) パラメータ:
戻り値: なし
DirectionsService の結果を使用するようにレンダラを設定します。この方法でルートの有効なセットを設定すると、レンダラの指定した地図とパネルにルートが表示されます。 |
setMap |
setMap(map) パラメータ:
戻り値: なし
このメソッドは、ルートがレンダリングされる地図を指定します。 null を渡して、地図からルートを削除します。 |
setOptions |
setOptions(options) パラメータ:
戻り値: なし
初期化後にこの DirectionsRenderer のオプション設定を変更します。 |
setPanel |
setPanel(panel) パラメータ:
戻り値: なし
このメソッドは、 <div> でルートをレンダリングします。パネルからコンテンツを削除するには、null を渡します。 |
setRouteIndex |
setRouteIndex(routeIndex) パラメータ:
戻り値: なし
レンダリングする DirectionsResult オブジェクト内のルートの(ゼロベースの)インデックスを設定します。デフォルトでは、配列内の最初のルートがレンダリングされます。 |
継承:
addListener 、
bindTo 、
get 、
notify 、
set 、
setValues 、
unbind 、
unbindAll
|
イベント | |
---|---|
directions_changed |
function() 引数: なし
このイベントは、新しい DirectionsResult が設定されたとき、またはユーザーが経路の変更のドラッグを完了したときに、レンダリングされたルートが変更されると発生します。 |
DirectionsRendererOptions インターフェース
google.maps.DirectionsRendererOptions
インターフェース
このオブジェクトは、DirectionsRenderer
オブジェクトに設定できるプロパティを定義します。
プロパティ | |
---|---|
directions optional |
タイプ:
DirectionsResult optional 地図または <div> パネルに表示する経路。DirectionsService から DirectionsResult オブジェクトとして取得されます。 |
draggable optional |
タイプ:
boolean optional true の場合、ユーザーはこの DirectionsRenderer によってレンダリングされたルートの経路をドラッグして変更できます。 |
hideRouteList optional |
タイプ:
boolean optional デフォルト:
false このプロパティは、レンダラが経路パネルに表示されるユーザーが選択可能なルートのリストを提供するかどうかを示します。 |
infoWindow optional |
タイプ:
InfoWindow optional マーカーがクリックされたときにテキスト情報をレンダリングする InfoWindow 。既存の情報ウィンドウのコンテンツは上書きされ、位置が移動します。情報ウィンドウが指定されていない場合、DirectionsRenderer は独自の情報ウィンドウを作成して使用します。suppressInfoWindows が true に設定されている場合、このプロパティは無視されます。 |
map optional |
タイプ:
Map optional ルートを表示する地図。 |
markerOptions optional |
タイプ:
MarkerOptions optional マーカーのオプション。 DirectionsRenderer によってレンダリングされるすべてのマーカーで、これらのオプションが使用されます。 |
panel optional |
タイプ:
HTMLElement optional 経路のステップを表示する <div> 。 |
polylineOptions optional |
タイプ:
PolylineOptions optional ポリラインのオプション。 DirectionsRenderer によってレンダリングされるすべてのポリラインで、これらのオプションが使用されます。 |
preserveViewport optional |
タイプ:
boolean optional デフォルト:
false このオプションが true に設定されている場合、または地図の中心とズームが設定されていない場合、入力地図は、この一連のルートの境界ボックスに中心が設定され、ズームされます。 |
routeIndex optional |
タイプ:
number optional DirectionsResult オブジェクト内のルートのインデックス。デフォルト値は 0 です。 |
suppressBicyclingLayer optional |
タイプ:
boolean optional 自転車ルートがリクエストされたときに BicyclingLayer のレンダリングを抑制します。 |
suppressInfoWindows optional |
タイプ:
boolean optional 情報ウィンドウのレンダリングを抑制します。 |
suppressMarkers optional |
タイプ:
boolean optional マーカーのレンダリングを抑制します。 |
suppressPolylines optional |
タイプ:
boolean optional ポリラインのレンダリングを抑制します。 |
DirectionsWaypoint インターフェース
google.maps.DirectionsWaypoint
インターフェース
DirectionsWaypoint
は、出発地と目的地の間の経由地を表します。
プロパティ | |
---|---|
location optional |
タイプ:
string|LatLng|LatLngLiteral|Place optional 経由地の場所。アドレス文字列、 LatLng 、Place のいずれかを指定できます。省略可。 |
stopover optional |
タイプ:
boolean optional デフォルト:
true true の場合、この地点が出発地と目的地の間の停車地であることを示します。これにより、ルートが 2 つの区間に分割されます。false の場合、ルートがこの地点を経由するようにバイアスをかけることを示します。ただし、2 つの区間に分割されません。これは、ユーザーが地図上の経由地をドラッグしたときにルートを作成する場合に便利です。 |
DirectionsGeocodedWaypoint インターフェース
google.maps.DirectionsGeocodedWaypoint
インターフェース
単一のジオコーディングされた経由地点。
プロパティ | |
---|---|
partial_match optional |
タイプ:
boolean optional ジオコーダによって、元の経由地に完全一致する住所は見つからなかったものの、部分一致する住所は見つかったかどうか。 |
place_id optional |
タイプ:
string optional 経由地に関連付けられたプレイス ID。プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。Places API デベロッパー ガイドのプレイス ID をご覧ください。 |
types optional |
タイプ:
Array<string> optional 返されたジオコード要素のタイプを示す文字列の配列。使用可能な文字列の一覧については、デベロッパー ガイドの アドレス コンポーネント タイプのセクションをご覧ください。 |
DirectionsRoute インターフェース
google.maps.DirectionsRoute
インターフェース
DirectionsResult
の一連の区間を含む単一のルート。このオブジェクトは「JSON のような」ものですが、LatLng
オブジェクトを直接的または間接的に含むため、厳密には JSON ではありません。
プロパティ | |
---|---|
bounds |
タイプ:
LatLngBounds このルートの境界。 |
copyrights |
タイプ:
string このルートに表示される著作権テキスト。 |
legs |
タイプ:
Array<DirectionsLeg> DirectionsLeg の配列。各 DirectionsLeg には、構成されているステップに関する情報が含まれています。経由地または目的地ごとに 1 つの区間があります。そのため、立ち寄り地点がないルートには 1 つの DirectionsLeg が含まれ、立ち寄り地点が 1 つあるルートには 2 つの DirectionsLeg が含まれます。 |
overview_path |
このルートの全コースを表す LatLng の配列。頂点数を少なくする必要があるコンテキスト(Static Maps API URL など)に適合するよう、パスは簡素化されます。 |
overview_polyline |
タイプ:
string overview_path のルートのエンコードされたポリライン表現。このポリラインは、結果のルートを近似した(平滑化した)経路です。 |
summary |
タイプ:
string ルートの短いテキストによる説明が含まれます。ルートの名前付けや、代替ルートとの区別に適しています。 |
warnings |
タイプ:
Array<string> これらのルートを示すときに表示される警告。 |
waypoint_order |
タイプ:
Array<number> optimizeWaypoints が true に設定されている場合、このフィールドには入力経由地の順序が変更された順列が含まれます。たとえば、入力が次の場合:出発地: ロサンゼルス 経由地: ダラス、バンガー、フェニックス 目的地: ニューヨーク 最適化された出力が次のように並べ替えられた場合: 出発地: ロサンゼルス 経由地: フェニックス、ダラス、バンガー 目的地: ニューヨーク このフィールドは、値 [2, 0, 1] を含む Array になります。ウェイポイントの番号付けはゼロベースであることに注意してください。入力経由地のいずれかで stopover が false に設定されている場合、このようなクエリではルートの最適化を利用できないため、このフィールドは空になります。 |
fare optional |
タイプ:
TransitFare optional 公共交通機関の全行程の合計運賃。乗換リクエストにのみ適用されます。 |
DirectionsLeg インターフェース
google.maps.DirectionsLeg
インターフェース
DirectionsResult
の一連のステップで構成される 1 つの区間。リクエストによっては、レッグの一部のフィールドが返されないことがあります。この結果は「JSON のような」ものですが、LatLng
オブジェクトを直接的または間接的に含むため、厳密には JSON ではありません。
プロパティ | |
---|---|
end_address |
タイプ:
string この区間の目的地の住所。このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。 |
end_location |
タイプ:
LatLng DirectionsService は、始点と終点に最も近い移動手段(通常は道路)を使用して位置を計算します。end_location は、実際にジオコーディングされた目的地を示します。たとえば、道路がこの区間の目的地付近にない場合、最後のステップの end_location とは異なる場合があります。 |
start_address |
タイプ:
string この区間の出発地の住所。このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。 |
start_location |
タイプ:
LatLng DirectionsService は、始点と終点に最も近い移動手段(通常は道路)を使用して位置を計算します。start_location は、ジオコードされた実際の出発地を示します。たとえば、道路がこの区間の出発地付近にない場合、最初のステップの start_location とは異なる場合があります。 |
steps |
タイプ:
Array<DirectionsStep> DirectionsStep の配列。各 DirectionsStep には、この区間の個々のステップに関する情報が含まれています。 |
|
タイプ:
Array<?> 区間の交通速度に関する情報。 |
via_waypoints |
この区間に沿った経由地以外の経由地の配列。元のリクエストで指定されています。 代替ルートでは非推奨。代替ルートの地点経由で他のルートを追加する API の最終バージョンは、3.27 です。 ルートサービスを使用してドラッグ可能なルートを実装する場合は、代替ルートのドラッグを無効にすることをおすすめします。ドラッグ可能にするのはメインルートのみにしてください。メインルートは、代替ルートと一致するまでドラッグできます。 |
arrival_time optional |
タイプ:
Time optional この区間の到着予定時刻。TRANSIT リクエストにのみ適用されます。 |
departure_time optional |
タイプ:
Time optional この区間の出発予定時刻。TRANSIT リクエストにのみ適用されます。 |
distance optional |
タイプ:
Distance optional この区間でカバーされる距離の合計。このプロパティは距離が不明な場合は未定義にできます。 |
duration optional |
タイプ:
Duration optional この区間の合計所要時間。所要時間が不明な場合があるため、このプロパティは undefined になることがあります。 |
duration_in_traffic optional |
タイプ:
Duration optional trafficModel プロパティで示される交通状況を考慮した、この区間の合計所要時間。所要時間が不明な場合があるため、このプロパティは undefined になることがあります。 |
DirectionsStep インターフェース
google.maps.DirectionsStep
インターフェース
DirectionsResult
内の単一の DirectionsStep
。一部のフィールドは undefined
になることがあります。このオブジェクトは「JSON のような」ものですが、LatLng
オブジェクトを直接含んでいるため、厳密には JSON ではありません。
プロパティ | |
---|---|
encoded_lat_lngs |
タイプ:
string ステップのエンコードされたポリライン表現。これは、ステップを近似した(平滑化した)経路です。 |
end_location |
タイプ:
LatLng このステップの終点の場所。 |
|
タイプ:
LatLng このステップの終点の場所。 |
instructions |
タイプ:
string このステップに対する指示。 |
|
このステップのコースを説明する LatLng のシーケンス。これは、ステップを近似した(平滑化した)経路です。 |
maneuver |
タイプ:
string 現在のステップで実行するアクション( turn-left 、merge 、straight など)が含まれます。値は変更されることがあり、新しい値が事前通知なしに導入されることがあります。 |
path |
このステップのコースを説明する LatLng のシーケンス。これは、ステップを近似した(平滑化した)経路です。 |
start_location |
タイプ:
LatLng このステップの始点の場所。 |
|
タイプ:
LatLng このステップの始点の場所。 |
travel_mode |
タイプ:
TravelMode このステップで使用されている交通手段。 |
distance optional |
タイプ:
Distance optional このステップで移動した距離。距離が不明な場合があるため、このプロパティは undefined になることがあります。 |
duration optional |
タイプ:
Duration optional このステップの実行に通常要する時間(秒単位、テキスト形式)。所要時間が不明な場合があるため、このプロパティは undefined になることがあります。 |
|
タイプ:
DirectionsPolyline optional ステップのエンコードされたポリライン表現を保持する単一のプロパティ「points」を含むオブジェクトが含まれます。このポリラインは、ステップを近似した(平滑化した)経路です。 |
steps optional |
タイプ:
Array<DirectionsStep> optional このステップのサブステップ。交通機関のルートの交通機関以外の区間で指定されます。 |
transit optional |
タイプ:
TransitDetails optional このステップに関する交通機関固有の詳細。このステップの移動手段が TRANSIT でない限り、このプロパティは未定義になります。 |
transit_details optional |
タイプ:
TransitDetails optional 移動手段が TRANSIT の場合、このステップに関する詳細。 |
DirectionsPolyline インターフェース
google.maps.DirectionsPolyline
インターフェース
DirectionsStep
のポリラインを記述する points
プロパティを含むオブジェクト。
プロパティ | |
---|---|
points |
タイプ:
string |
Place インターフェース
google.maps.Place
インターフェース
DirectionsRequest
または DistanceMatrixRequest
の場所を特定、識別、説明するために必要な情報が含まれています。この場合の「場所」とは、お店やサービス、スポット、地理的位置を指します。場所に関する情報の取得については、PlacesService
をご覧ください。
プロパティ | |
---|---|
location optional |
タイプ:
LatLng|LatLngLiteral optional この場所で説明されているエンティティの LatLng 。 |
placeId optional |
タイプ:
string optional 場所(ビジネス拠点や有名スポットなど)のプレイス ID。プレイス ID は、Google マップのデータベース内の場所の一意の識別子です。 placeId は場所を特定する最も正確な方法です。可能な場合は、query ではなく placeId を指定する必要があります。プレイス ID は、TextSearch など、Places API への任意のリクエストから取得できます。プレイス ID は、Geocoding API へのリクエストから取得することもできます。詳しくは、プレイス ID の概要をご覧ください。 |
query optional |
タイプ:
string optional 場所(ビジネスやスポットなど)を説明する検索語句。クエリの例: 「Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW」。可能な場合は、 query ではなく placeId を指定する必要があります。API は、クエリ文字列を場所に解決する精度を保証しません。placeId と query の両方が指定されている場合、エラーが発生します。 |
TravelMode 定数
google.maps.TravelMode
定数
DirectionsRequest
で指定できる有効な移動手段と、DirectionsStep
で返される移動手段。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'BICYCLING'
や google.maps.TravelMode.BICYCLING
です。
const {TravelMode} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BICYCLING |
自転車ルート リクエストを指定します。 |
DRIVING |
運転ルート リクエストを指定します。 |
TRANSIT |
公共交通機関のルート リクエストを指定します。 |
WALKING |
徒歩ルート リクエストを指定します。 |
DrivingOptions インターフェース
google.maps.DrivingOptions
インターフェース
移動モードが DRIVING
に設定されている場合に DirectionsRequest
を構成します。
プロパティ | |
---|---|
departureTime |
タイプ:
Date ルートの希望する出発時刻。 Date オブジェクトとして指定します。Date オブジェクトは、1970 年 1 月 1 日からのミリ秒単位で時間を測定します。DrivingOptions を有効にするには、これを指定する必要があります。出発時刻は、現在時刻または将来の時刻に設定する必要があります。過去の時刻は指定できません。 |
trafficModel optional |
タイプ:
TrafficModel optional 交通状況での所要時間を予測する際に使用する優先される仮定。デフォルト値は BEST_GUESS です。 |
TrafficModel 定数
google.maps.TrafficModel
定数
交通状況での所要時間を予測する際に使用する仮定。DirectionsRequest
または DistanceMatrixRequest
の一部として指定されます。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'bestguess'
や google.maps.TrafficModel.BEST_GUESS
です。
const {TrafficModel} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BEST_GUESS |
過去の交通データを使用して、交通渋滞に費やす時間を正確に予測します。 |
OPTIMISTIC |
過去の交通データを使用して、交通状況での所要時間を楽観的に見積もります。 |
PESSIMISTIC |
過去の交通データを使用して、交通渋滞の所要時間を悲観的に見積もります。 |
TransitOptions インターフェース
google.maps.TransitOptions
インターフェース
交通手段が TRANSIT に設定されている場合に DirectionsRequest
に含める TransitOptions オブジェクト。
プロパティ | |
---|---|
arrivalTime optional |
タイプ:
Date optional ルートの希望到着時刻。Date オブジェクトとして指定します。Date オブジェクトは、1970 年 1 月 1 日からの経過時間をミリ秒単位で測定します。到着時刻が指定された場合、出発時刻は無視されます。 |
departureTime optional |
タイプ:
Date optional ルートの希望する出発時刻。Date オブジェクトとして指定します。Date オブジェクトは、1970 年 1 月 1 日からの経過時間をミリ秒単位で測定します。出発時刻も到着時刻も指定されていない場合、時刻は「現在」とみなされます。 |
modes optional |
タイプ:
Array<TransitMode> optional バスや電車など、優先する 1 つ以上の交通手段。優先度が指定されていない場合、API はデフォルトの最適ルートを返します。 |
routingPreference optional |
タイプ:
TransitRoutePreference optional 徒歩での移動が少ないなど、公共交通機関のルートの選択に影響する設定。優先度が指定されていない場合、API はデフォルトの最適ルートを返します。 |
TransitMode 定数
google.maps.TransitMode
定数
TransitOptions
で指定できる有効な交通手段(バスなど)。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'BUS'
や google.maps.TransitMode.BUS
です。
const {TransitMode} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BUS |
バスを優先する交通手段として指定します。 |
RAIL |
鉄道を優先する交通手段として指定します。 |
SUBWAY |
地下鉄を優先する交通手段として指定します。 |
TRAIN |
電車を優先する交通手段として指定します。 |
TRAM |
優先する交通手段として路面電車を指定します。 |
TransitRoutePreference 定数
google.maps.TransitRoutePreference
定数
TransitOptions
で指定できる有効な交通機関のルートタイプ。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'LESS_WALKING'
や google.maps.TransitRoutePreference.LESS_WALKING
です。
const {TransitRoutePreference} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
FEWER_TRANSFERS |
乗り換え回数に制限を付けてルートを計算するよう指定します。 |
LESS_WALKING |
歩行距離に制限を付けてルートを計算するよう指定します。 |
TransitFare インターフェース
google.maps.TransitFare
インターフェース
値と通貨で構成される DirectionsRoute
の運賃。
プロパティ | |
---|---|
currency |
タイプ:
string 運賃を表示する通貨を示す ISO 4217 通貨コード。 |
text |
タイプ:
string 指定された currency で表された運賃の値(文字列)。 |
value |
タイプ:
number 運賃の数値。指定された currency で表されます。 |
TransitDetails インターフェース
google.maps.TransitDetails
インターフェース
このステップで使用される出発地、到着地、交通手段に関する詳細。
プロパティ | |
---|---|
arrival_stop |
タイプ:
TransitStop この交通機関のステップの到着停留所。 |
arrival_time |
タイプ:
Time このステップの到着時刻。Time オブジェクトとして指定されます。 |
departure_stop |
タイプ:
TransitStop この交通機関ステップの出発停留所。 |
departure_time |
タイプ:
Time このステップの出発時刻。Time オブジェクトとして指定します。 |
headsign |
タイプ:
string 車両または出発駅に示されている、この路線を進む方向。 |
headway |
タイプ:
number この停留所における同等の車両間の推定間隔(秒単位)。 |
line |
タイプ:
TransitLine このステップで使用される交通機関の路線に関する詳細。 |
num_stops |
タイプ:
number このステップの停車地の数。この数には到着地点の駅や停留所は含まれますが、出発地点の駅や停留所は含まれません。 |
trip_short_name |
タイプ:
string 乗客が公共交通機関の旅程を識別できるよう時刻表と行先表示に使用されるテキスト。たとえば通勤電車の列車番号などがこれに該当します。このテキストは、運行日の特定の旅程を一意に識別します。 |
TransitStop インターフェース
google.maps.TransitStop
インターフェース
停留所または駅に関する詳細。
プロパティ | |
---|---|
location |
タイプ:
LatLng この停車地の位置。 |
name |
タイプ:
string この停留所の名前。 |
TransitLine インターフェース
google.maps.TransitLine
インターフェース
この交通機関のステップを運行する交通機関の路線に関する情報。
プロパティ | |
---|---|
agencies |
タイプ:
Array<TransitAgency> この交通機関の路線を運行する交通機関。 |
color |
タイプ:
string この交通機関の路線で一般的に使用される色。16 進文字列で表されます。 |
icon |
タイプ:
string この路線に関連付けられたアイコンの URL。 |
name |
タイプ:
string この路線の正式名称(例: 「8 Avenue Local」)。 |
short_name |
タイプ:
string この路線の略称(「E」など)。 |
text_color |
タイプ:
string この交通機関の路線で一般的に使用される表記のテキストの色。16 進文字列で表されます。 |
url |
タイプ:
string この交通機関の路線に固有の交通機関の URL。 |
vehicle |
タイプ:
TransitVehicle 使用した交通手段(電車、バスなど)。 |
TransitAgency インターフェース
google.maps.TransitAgency
インターフェース
交通機関の路線を運営する機関に関する情報。
プロパティ | |
---|---|
name |
タイプ:
string この交通機関の名前。 |
phone |
タイプ:
string 交通機関の電話番号。 |
url |
タイプ:
string 交通機関の URL。 |
TransitVehicle インターフェース
google.maps.TransitVehicle
インターフェース
交通機関の路線を走行する車両に関する情報。
プロパティ | |
---|---|
icon |
タイプ:
string この路線で使用される車両のタイプに対応するアイコンの URL。 |
local_icon |
タイプ:
string より一般的なアイコンではなく、この地域で使用される車両のタイプに対応するアイコンの URL。 |
name |
タイプ:
string このタイプの TransitVehicle の名前(「電車」や「バス」など)。 |
type |
タイプ:
VehicleType 使用される車両の種類(電車、バス、フェリーなど)。 |
VehicleType 定数
google.maps.VehicleType
定数
車両タイプの有効な値。
const {VehicleType} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BUS |
バス。 |
CABLE_CAR |
ケーブルによって、通常は地上を走る車両。空中ケーブルカーは、タイプ GONDOLA_LIFT に入ることもあります。 |
COMMUTER_TRAIN |
通勤列車。 |
FERRY |
フェリー。 |
FUNICULAR |
険しい斜面をケーブルで引っ張る乗り物。 |
GONDOLA_LIFT |
空中ケーブルカー。 |
HEAVY_RAIL |
ヘビーレール。 |
HIGH_SPEED_TRAIN |
高速列車。 |
INTERCITY_BUS |
長距離バス。 |
METRO_RAIL |
ライトレール。 |
MONORAIL |
モノレール。 |
OTHER |
その他の車両。 |
RAIL |
鉄道。 |
SHARE_TAXI |
乗り合いタクシーはバスの一種で、乗客はルート上のどこでも乗車、降車できます。一般的に、共有タクシーではミニバス車両が使用されます。 |
SUBWAY |
地下を走るライトレール。 |
TRAM |
地上を走るライトレール。 |
TROLLEYBUS |
トロリーバス。 |
UnitSystem 定数
google.maps.UnitSystem
定数
DirectionsRequest
で指定できる有効な単位系。
const {UnitSystem} = await google.maps.importLibrary("core")
を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
IMPERIAL |
DirectionsResult の距離をヤード・ポンド法で表すことを指定します。 |
METRIC |
DirectionsResult の距離をメートル単位で表すことを指定します。 |
Distance インターフェース
google.maps.Distance
インターフェース
数値および表示文字列による距離の表現。
プロパティ | |
---|---|
text |
タイプ:
string リクエストで指定された UnitSystem を使用した距離値の文字列形式。 |
value |
タイプ:
number メートル単位の距離。 |
Duration インターフェース
google.maps.Duration
インターフェース
数値および表示文字列による所要時間の表現。
プロパティ | |
---|---|
text |
タイプ:
string 所要時間の値の文字列表現。 |
value |
タイプ:
number 秒単位の所要時間。 |
Time インターフェース
google.maps.Time
インターフェース
Date オブジェクト、ローカライズされた文字列、タイムゾーンとしての時刻の表現。
プロパティ | |
---|---|
text |
タイプ:
string 時刻の値を表す文字列。この時刻は、交通機関の停止地点におけるタイムゾーンで表示されます。 |
time_zone |
タイプ:
string この停留所があるタイムゾーン。この値は、IANA タイムゾーン データベースで定義されたタイムゾーンの名前です(例: America/New_York)。 |
value |
タイプ:
Date この出発または到着の時刻。JavaScript Date オブジェクトとして指定されます。 |
DirectionsTravelMode 定数
google.maps.DirectionsTravelMode
定数
DirectionsUnitSystem 定数
google.maps.DirectionsUnitSystem
定数