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 の場合、可能であれば有料区間を回避するようルート検索サービスに指示します。省略可。 |
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 には、構成される区間とステップに関する情報が含まれています。provideRouteAlternatives が true に設定された DirectionsRequest が作成されていない限り、ルートは 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 です。Place ID の詳細については、Places API デベロッパー ガイドをご覧ください。 |
types optional |
タイプ:
Array<string> optional 返されたジオコーディングされた要素のタイプを示す文字列の配列。使用可能な文字列の一覧については、デベロッパー ガイドの 住所のコンポーネント タイプをご覧ください。 |
DirectionsRoute インターフェース
google.maps.DirectionsRoute
インターフェース
DirectionsResult
内の一連の乗車区間を含む単一のルート。このオブジェクトは「JSON に似ている」ものの、LatLng
オブジェクトが直接的または間接的に含まれているため、厳密には JSON ではありません。
プロパティ | |
---|---|
bounds |
タイプ:
LatLngBounds このルートの境界。 |
copyrights |
タイプ:
string このルートに表示される著作権テキスト。 |
legs |
タイプ:
Array<DirectionsLeg> DirectionsLeg の配列。各 DirectionsLeg には、構成されているステップに関する情報が含まれています。指定した経由地のウェイポイントまたは目的地ごとに、1 つの区間が存在します。そのため、立ち寄り地点がないルートには DirectionsLeg が 1 つ含まれ、立ち寄り地点が 1 つのルートには 2 つ含まれます。 |
overview_path |
このルートのコース全体を表す LatLng の配列。頂点数を少なくする必要があるコンテキスト(Static Maps API URL など)に適合するよう、パスは簡素化されます。 |
overview_polyline |
タイプ:
string overview_path 内のエンコードされたポリライン表現。このポリラインは、結果のルートを近似した(平滑化した)経路です。 |
summary |
タイプ:
string ルートの簡単な説明をテキストで指定します。名前を付けたり、代替ルートとの区別をつけたりするのに適しています。 |
warnings |
タイプ:
Array<string> これらのルートを示すときに表示される警告。 |
waypoint_order |
タイプ:
Array<number> optimizeWaypoints が true に設定されている場合、このフィールドには入力ウェイポイントの並べ替えられた順序が含まれます。たとえば、入力が Origin: Los Angeles Waypoints: Dallas, Bangor, Phoenix Destination: New York で、最適化された出力が次のように並べ替えられた場合、 Origin: Los Angeles Waypoints: Phoenix, Dallas, Bangor Destination: New York となると、このフィールドは値 [2, 0, 1] を含む Array になります。ウェイポイントの番号付けはゼロベースであることに注意してください。入力ウェイポイントのいずれかで stopover が false に設定されている場合、そのようなクエリではルート最適化を使用できないため、このフィールドは空になります。 |
fare optional |
タイプ:
TransitFare optional 交通機関のルート全体の運賃の合計額。乗換案内リクエストにのみ適用されます。 |
DirectionsLeg インターフェース
google.maps.DirectionsLeg
インターフェース
DirectionsResult
内の一連のステップで構成される単一の区間。ルートの一部のフィールドは、すべてのリクエストで返されない場合があります。この結果は「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 |
この区間にある、途中降機なしのウェイポイントの配列。元のリクエストで指定されたものです。 代替ルートで非推奨になりました。代替ルートに追加の ルートサービスを使用してドラッグ可能なルートを実装する場合は、代替ルートのドラッグを無効にすることをおすすめします。ドラッグ可能にするのはメインルートのみにしてください。メインルートは、代替ルートと一致するまでドラッグできます。 |
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 マップ データベース内の場所を一意に識別する ID です。 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 通貨コード。 |
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
定数