DirectionsService クラス
google.maps.DirectionsService
クラス
ライブラリ "routes"
const {DirectionsService} = await google.maps.importLibrary("routes");
コンストラクタ | |
|---|---|
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
省略可 |
タイプ:
boolean optionaltrue の場合、可能であればフェリーを利用しないようルートサービスに指示します。省略可。 |
avoidHighways
省略可 |
タイプ:
boolean optionaltrue の場合、可能であれば高速道路を避けるようルートサービスに指示します。省略可。 |
avoidTolls
省略可 |
タイプ:
boolean optionaltrue の場合、可能であれば有料道路を避けるようルートサービスに指示します。省略可。 |
drivingOptions
省略可 |
タイプ:
DrivingOptions optionaltravelMode が DRIVING であるリクエストにのみ適用される設定。このオブジェクトは、他の移動手段には影響しません。 |
language
省略可 |
タイプ:
string optional可能な場合に結果を返す言語の言語識別子。サポートされている言語の一覧をご覧ください。 |
optimizeWaypoints
省略可 |
タイプ:
boolean optionaltrue に設定すると、DirectionsService は、ルートの全体的なコストを最小限に抑えるために、指定された中間ウェイポイントの順序を変更しようとします。経由地が最適化されている場合は、レスポンスの DirectionsRoute.waypoint_order を調べて新しい順序を決定します。 |
provideRouteAlternatives
省略可 |
タイプ:
boolean optional代替ルートを提供するかどうか。省略可。 |
region
省略可 |
タイプ:
string optionalジオコーディング リクエストのバイアスとして使用されるリージョン コード。地域コードには、ccTLD(「トップレベル ドメイン」)の 2 文字の値を指定できます。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」( .co.uk)ですが、ISO 3166-1 コードは「gb」です(厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ)。 |
transitOptions
省略可 |
タイプ:
TransitOptions optionaltravelMode が TRANSIT であるリクエストにのみ適用される設定。このオブジェクトは、他の移動手段には影響しません。 |
unitSystem
省略可 |
タイプ:
UnitSystem optionalデフォルト: 出発地の国で使用されている単位系。
距離を表示する際に使用される、優先単位系。 |
waypoints
省略可 |
タイプ:
Array<DirectionsWaypoint> optional中間ウェイポイントの配列。ルートは、この配列内の各ウェイポイントを経由して、出発地から目的地まで計算されます。許可されるウェイポイントの最大数については、 デベロッパー ガイドをご覧ください。地点は乗換案内では利用できません。省略可。 |
DirectionsStatus 定数
google.maps.DirectionsStatus
constants
library "routes"
route() の呼び出しの完了時に DirectionsService によって返されるステータス。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'OK' や google.maps.DirectionsStatus.OK です。
これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは DirectionsStatusString 型で定義されます。
const {DirectionsStatus} = await google.maps.importLibrary("routes");
定数 | |
|---|---|
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> の配列。各 には、それを構成する区間とステップに関する情報が含まれます。 DirectionsRouteDirectionsRequest が provideRouteAlternatives を true に設定して作成されていない限り、ルートは 1 つだけです。 |
available_travel_modes
省略可 |
タイプ:
Array<TravelMode> optional利用可能な移動手段の配列が含まれます。このフィールドは、リクエストで移動手段が指定され、結果が返されない場合に返されます。この配列には、指定された一連のウェイポイントの国で利用可能な移動手段が含まれます。1 つ以上のウェイポイントが「経由ウェイポイント」の場合、このフィールドは返されません。 |
geocoded_waypoints
省略可 |
タイプ:
Array<DirectionsGeocodedWaypoint> optionalDirectionsGeocodedWaypoint の配列。各 DirectionsGeocodedWaypoint には、出発地、目的地、地点のジオコーディングに関する情報が含まれます。 |
DirectionsRenderer クラス
google.maps.DirectionsRenderer
class
extends MVCObject
library "routes"
const {DirectionsRenderer} = await google.maps.importLibrary("routes");
コンストラクタ | |
|---|---|
DirectionsRenderer |
DirectionsRenderer([opts])パラメータ:
指定されたオプションを使用してレンダラを作成します。ルートは、地図上に(視覚的なオーバーレイとして)レンダリングすることも、 <div> パネルに(テキストによる指示として)レンダリングすることもできます。 |
メソッド | |
|---|---|
getDirections |
getDirections()パラメータ: なし
戻り値:
DirectionsResult|nullレンダラの現在のルートのセットを返します。 |
getMap |
getMap()パラメータ: なし
戻り値:
Map|nullDirectionsResult がレンダリングされる地図を返します。 |
getPanel |
getPanel()パラメータ: なし
戻り値:
HTMLElement|nullDirectionsResult がレンダリングされるパネル <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
省略可 |
タイプ:
DirectionsResult optional地図や <div> パネルに表示するルート。DirectionsService から DirectionsResult オブジェクトとして取得されます。 |
draggable
省略可 |
タイプ:
boolean optionaltrue の場合、ユーザーはこの DirectionsRenderer によってレンダリングされたルートのパスをドラッグして変更できます。 |
hideRouteList
省略可 |
タイプ:
boolean optionalデフォルト:
falseこのプロパティは、ルートパネルに表示されるルートのリストをレンダラが提供するかどうかを示します。 |
infoWindow
省略可 |
タイプ:
InfoWindow optionalマーカーがクリックされたときにテキスト情報をレンダリングする InfoWindow。既存の情報ウィンドウのコンテンツは上書きされ、位置が移動します。情報ウィンドウが指定されていない場合、DirectionsRenderer は独自の情報ウィンドウを作成して使用します。suppressInfoWindows が true に設定されている場合、このプロパティは無視されます。 |
map
省略可 |
タイプ:
Map optionalルートを表示する地図。 |
markerOptions
省略可 |
タイプ:
MarkerOptions optionalマーカーのオプション。 DirectionsRenderer によってレンダリングされるすべてのマーカーで、これらのオプションが使用されます。 |
panel
省略可 |
タイプ:
HTMLElement optionalルート案内を表示する <div>。 |
polylineOptions
省略可 |
タイプ:
PolylineOptions optionalポリラインのオプション。 DirectionsRenderer によってレンダリングされるすべてのポリラインで、これらのオプションが使用されます。 |
preserveViewport
省略可 |
タイプ:
boolean optionalデフォルト:
falseこのオプションが true に設定されている場合、または地図の中心とズームが設定されていない場合、入力地図は、この一連のルートの境界ボックスに中心が設定され、ズームされます。 |
routeIndex
省略可 |
タイプ:
number optionalDirectionsResult オブジェクト内のルートのインデックス。デフォルト値は 0 です。 |
suppressBicyclingLayer
省略可 |
タイプ:
boolean optional自転車ルートがリクエストされたときに BicyclingLayer のレンダリングを抑制します。 |
suppressInfoWindows
省略可 |
タイプ:
boolean optional情報ウィンドウのレンダリングを抑制します。 |
suppressMarkers
省略可 |
タイプ:
boolean optionalマーカーのレンダリングを抑制します。 |
suppressPolylines
省略可 |
タイプ:
boolean optionalポリラインのレンダリングを抑制します。 |
DirectionsWaypoint インターフェース
google.maps.DirectionsWaypoint インターフェース
DirectionsWaypoint は、出発地と目的地の間にあり、ルートに含める必要がある場所を表します。
プロパティ | |
|---|---|
location
省略可 |
タイプ:
string|LatLng|LatLngLiteral|Place optionalウェイポイントの場所。アドレス文字列、 LatLng、Place のいずれかを指定できます。省略可。 |
stopover
省略可 |
タイプ:
boolean optionalデフォルト:
truetrue の場合、このウェイポイントが出発地と目的地の間の停車地点であることを示します。これにより、ルートが 2 つの区間に分割されます。false の場合、ルートはこのウェイポイントを通過するようにバイアスされますが、2 つの区間に分割されることはありません。これは、ユーザーが地図上でウェイポイントをドラッグしたときにルートを作成する場合に便利です。 |
DirectionsGeocodedWaypoint インターフェース
google.maps.DirectionsGeocodedWaypoint インターフェース
ジオコーディングされた単一のウェイポイント。
プロパティ | |
|---|---|
partial_match
省略可 |
タイプ:
boolean optionalジオコーダによって、元のウェイポイントに完全一致する住所は見つからなかったものの、部分一致する住所は見つかったかどうか。 |
place_id
省略可 |
タイプ:
string optionalウェイポイントに関連付けられたプレイス ID。プレイス ID は、Google プレイスのデータベースおよび Google マップで、特定の場所を一意に識別する ID です。プレイス ID の詳細については、Places API デベロッパー ガイドをご覧ください。 |
types
省略可 |
タイプ:
Array<string> optional返されたジオコーディングされた要素のタイプを示す文字列の配列。指定可能な文字列の一覧については、デベロッパー ガイドの 住所コンポーネントのタイプをご覧ください。 |
DirectionsRoute インターフェース
google.maps.DirectionsRoute インターフェース
DirectionsResult 内の一連の区間を含む単一のルート。このオブジェクトは「JSON に似ている」ものの、LatLng オブジェクトを直接的および間接的に含むため、厳密には JSON ではありません。
プロパティ | |
|---|---|
bounds |
タイプ:
LatLngBoundsこのルートの境界。 |
copyrights |
タイプ:
stringこのルートに表示される著作権テキスト。 |
legs |
タイプ:
Array<DirectionsLeg> の配列。各 には、それを構成するステップに関する情報が含まれます。 DirectionsLeg指定した経由地や目的地ごとに、1 つの区間が存在します。したがって、立ち寄り地点がないルートには DirectionsLeg が 1 つ含まれ、立ち寄り地点が 1 つあるルートには 2 つ含まれます。 |
overview_path |
このルートのコース全体を表す LatLng の配列。頂点数を少なくする必要があるコンテキスト(Static Maps API URL など)に適合するよう、パスは簡素化されます。 |
overview_polyline |
タイプ:
stringoverview_path のルートのエンコードされたポリライン表現。このポリラインは、結果のルートを近似した(平滑化した)経路です。 |
summary |
タイプ:
stringルートの簡単な説明が含まれます。この説明は、ルートに名前を付けたり、代替ルートと区別したりするのに適しています。 |
warnings |
タイプ:
Array<string>これらのルートを示すときに表示される警告。 |
waypoint_order |
タイプ:
Array<number>optimizeWaypoints が true に設定されている場合、このフィールドには、入力されたウェイポイントの並べ替えられた順列が含まれます。たとえば、入力が次の場合:出発地: ロサンゼルス 経由地: ダラス、バンゴー、フェニックス 目的地: ニューヨーク 最適化された出力が次のように並べ替えられた場合: 出発地: ロサンゼルス 経由地: フェニックス、ダラス、バンゴー 目的地: ニューヨーク このフィールドは、値 [2, 0, 1] を含む Array になります。ウェイポイントの番号付けはゼロベースであることに注意してください。入力されたウェイポイントのいずれかで stopover が false に設定されている場合、このフィールドは空になります。このようなクエリではルートの最適化が利用できないためです。 |
fare
省略可 |
タイプ:
TransitFare optional乗換案内ルート全体の合計運賃。乗換案内リクエストにのみ適用されます。 |
DirectionsLeg インターフェース
google.maps.DirectionsLeg インターフェース
DirectionsResult の一連のステップで構成される 1 つの区間。区間の一部のフィールドは、すべてのリクエストで返されるとは限りません。この結果は「JSON のような」ものですが、LatLng オブジェクトを直接的および間接的に含むため、厳密には JSON ではありません。
プロパティ | |
|---|---|
end_address |
タイプ:
stringこの区間の目的地の住所。このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。 |
end_location |
タイプ:
LatLngDirectionsService は、始点と終点に最も近い移動手段(通常は道路)を使用して位置を計算します。end_location は、ジオコーディングされた実際の目的地を示します。これは、最後のステップの end_location とは異なる場合があります(道路がこの区間の目的地付近にない場合など)。 |
start_address |
タイプ:
stringこの区間の出発地の住所。このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。 |
start_location |
タイプ:
LatLngDirectionsService は、始点と終点に最も近い移動手段(通常は道路)を使用して位置を計算します。start_location は、ジオコードされた実際の出発地を示します。たとえば、道路がこの区間の出発地付近にない場合、最初のステップの start_location とは異なる場合があります。 |
steps |
タイプ:
Array<DirectionsStep> の配列。各 には、この区間の個々のステップに関する情報が含まれます。 DirectionsStep |
|
タイプ:
Array<*>区間の交通速度に関する情報。 |
via_waypoints |
この区間に沿った、元のリクエストで指定された非立ち寄りウェイポイントの配列。 代替ルートでは非推奨。代替ルートの Directions Service を使用してドラッグ可能なルートを実装する場合は、代替ルートのドラッグを無効にすることをおすすめします。ドラッグ可能にするのはメインルートのみにしてください。メインルートは、代替ルートと一致するまでドラッグできます。 |
arrival_time
省略可 |
タイプ:
Time optionalこの区間の到着予定時刻。TRANSIT リクエストにのみ適用されます。 |
departure_time
省略可 |
タイプ:
Time optionalこの区間の出発予定時刻。TRANSIT リクエストにのみ適用されます。 |
distance
省略可 |
タイプ:
Distance optionalこの区間でカバーされる距離の合計。このプロパティは距離が不明な場合は未定義にできます。 |
duration
省略可 |
タイプ:
Duration optionalこの区間の合計所要時間。所要時間が不明な場合、このプロパティは undefined になることがあります。 |
duration_in_traffic
省略可 |
タイプ:
Duration optionaltrafficModel プロパティで示される交通状況を考慮して計算した、この区間の合計所要時間です。所要時間が不明な場合、このプロパティは 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
省略可 |
タイプ:
Distance optionalこのステップの移動距離。距離が不明な場合、このプロパティは undefined になることがあります。 |
duration
省略可 |
タイプ:
Duration optionalこのステップの実行に通常必要な時間(秒単位、テキスト形式)。所要時間が不明な場合、このプロパティは undefined になることがあります。 |
省略可 |
タイプ:
DirectionsPolyline optionalステップのエンコードされたポリライン表現を保持する単一のプロパティ「points」を持つオブジェクトが含まれます。このポリラインは、ステップを近似した(平滑化した)経路です。 |
steps
省略可 |
タイプ:
Array<DirectionsStep> optionalこのステップのサブステップ。乗換ルートの乗換以外の区間に指定します。 |
transit
省略可 |
タイプ:
TransitDetails optionalこのステップに関する交通機関固有の詳細。このプロパティは、このステップの移動手段が TRANSIT でない限り、未定義になります。 |
transit_details
省略可 |
タイプ:
TransitDetails optional移動手段が TRANSIT の場合の、このステップに関する詳細。 |
DirectionsPolyline インターフェース
google.maps.DirectionsPolyline インターフェース
DirectionsStep のポリラインを記述する points プロパティを含むオブジェクト。
プロパティ | |
|---|---|
points |
タイプ:
string |
Place インターフェース
google.maps.Place インターフェース
DirectionsRequest または DistanceMatrixRequest の場所を特定、識別、記述するために必要な情報が含まれています。この場合の「場所」とは、お店やサービス、スポット、地理的位置を指します。場所に関する情報を取得するには、PlacesService をご覧ください。
プロパティ | |
|---|---|
location
省略可 |
タイプ:
LatLng|LatLngLiteral optionalこの場所で説明されているエンティティの LatLng。 |
placeId
省略可 |
タイプ:
string optional場所(ビジネスやスポットなど)のプレイス ID。プレイス ID は、Google マップのデータベース内の場所を表す固有識別子です。 placeId は、場所を特定する最も正確な方法です。query ではなく placeId を指定することをおすすめします。プレイス ID は、TextSearch など、Places API へのリクエストから取得できます。プレイス ID は、Geocoding API へのリクエストから取得することもできます。詳しくは、プレイス ID の概要をご覧ください。 |
query
省略可 |
タイプ:
string optional場所(ビジネスやスポットなど)を説明する検索クエリ。クエリの例は「Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW」です。 query ではなく placeId を指定することをおすすめします。この API は、クエリ文字列を場所として解決する際の精度を保証するものではありません。placeId と query の両方が指定されている場合は、エラーが発生します。 |
TravelMode 定数
google.maps.TravelMode
constants
library "routes"
DirectionsRequest で指定できる有効な移動手段と、DirectionsStep で返される移動手段。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'BICYCLING' や google.maps.TravelMode.BICYCLING です。
これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは TravelModeString 型で定義されます。
const {TravelMode} = await google.maps.importLibrary("routes");
定数 | |
|---|---|
BICYCLING |
自転車ルート リクエストを指定します。 |
DRIVING |
運転ルート リクエストを指定します。 |
TRANSIT |
乗換案内リクエストを指定します。 |
|
オートバイのルート検索リクエストを指定します。 |
WALKING |
徒歩ルート リクエストを指定します。 |
DrivingOptions インターフェース
google.maps.DrivingOptions インターフェース
移動モードが DRIVING に設定されている場合に DirectionsRequest を構成します。
プロパティ | |
|---|---|
departureTime |
タイプ:
Dateルートの希望出発時刻。 Date オブジェクトとして指定します。Date オブジェクトは、1970 年 1 月 1 日からの時間をミリ秒単位で測定します。DrivingOptions が有効になるように、これを指定する必要があります。出発時刻は、現在時刻または将来の時刻に設定する必要があります。過去の時刻は指定できません。 |
trafficModel
省略可 |
タイプ:
TrafficModel optional交通状況を考慮した所要時間を予測する際に使用する、優先される前提条件。デフォルト値は BEST_GUESS です。 |
TrafficModel 定数
google.maps.TrafficModel
constants
library "routes"
交通状況を考慮した所要時間を予測する際に使用する前提条件。DirectionsRequest または DistanceMatrixRequest の一部として指定します。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'bestguess' や google.maps.TrafficModel.BEST_GUESS です。
これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは TrafficModelString 型で定義されます。
const {TrafficModel} = await google.maps.importLibrary("routes");
定数 | |
|---|---|
BEST_GUESS |
過去の交通データを使用して、交通渋滞に費やした時間を最適に推定します。 |
OPTIMISTIC |
過去の交通データを使用して、交通状況を考慮した所要時間を楽観的に見積もる。 |
PESSIMISTIC |
過去の交通データを使用して、交通状況を考慮した所要時間を悲観的に見積もります。 |
TransitOptions インターフェース
google.maps.TransitOptions インターフェース
移動手段が TRANSIT に設定されている場合に DirectionsRequest に含める TransitOptions オブジェクト。
プロパティ | |
|---|---|
arrivalTime
省略可 |
タイプ:
Date optionalルートの希望到着時刻。Date オブジェクトとして指定します。Date オブジェクトは、1970 年 1 月 1 日からのミリ秒単位で時間を測定します。到着時刻が指定された場合、出発時刻は無視されます。 |
departureTime
省略可 |
タイプ:
Date optionalルートの希望出発時刻。Date オブジェクトとして指定します。Date オブジェクトは、1970 年 1 月 1 日からのミリ秒単位で時間を測定します。出発時刻も到着時刻も指定されていない場合、時刻は「現在」と見なされます。 |
modes
省略可 |
タイプ:
Array<TransitMode> optionalバスや電車など、優先する 1 つ以上の交通手段。優先順位が指定されていない場合、API はデフォルトの最適ルートを返します。 |
routingPreference
省略可 |
タイプ:
TransitRoutePreference optional徒歩での移動が少ないなど、乗り換えルートの選択に影響を与える設定。優先順位が指定されていない場合、API はデフォルトの最適ルートを返します。 |
TransitMode 定数
google.maps.TransitMode
constants
library "routes"
TransitOptions で指定できる有効な交通機関モード(バスなど)。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'BUS' や google.maps.TransitMode.BUS です。
これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは TransitModeString 型で定義されます。
const {TransitMode} = await google.maps.importLibrary("routes");
定数 | |
|---|---|
BUS |
優先する移動手段としてバスを指定します。 |
|
優先する移動手段として路面電車を指定します。 |
RAIL |
鉄道を優先する移動手段として指定します。 |
SUBWAY |
優先する移動手段として地下鉄を指定します。 |
TRAIN |
電車を優先する移動手段として指定します。 |
TRAM |
希望する移動手段として路面電車を指定します。 |
TransitRoutePreference 定数
google.maps.TransitRoutePreference
constants
library "routes"
TransitOptions で指定できる有効な交通機関のルートタイプ。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'LESS_WALKING' や google.maps.TransitRoutePreference.LESS_WALKING です。
これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは TransitRoutePreferenceString 型で定義されます。
const {TransitRoutePreference} = await google.maps.importLibrary("routes");
定数 | |
|---|---|
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乗客がルートを識別できるように、時刻表や案内板に表示されるテキスト。たとえば通勤電車の列車番号(便名)などがこれに該当します。このテキストは、1 日の運行内のルートを一意に識別します。 |
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
constants
library "routes"
車両タイプに指定できる値。
これらの定数は文字列としても使用できます。TypeScript では、文字列リテラルは VehicleTypeString 型で定義されます。
const {VehicleType} = await google.maps.importLibrary("routes");
定数 | |
|---|---|
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
constants
library "core"
DirectionsRequest で指定できる有効な単位系。
const {UnitSystem} = await google.maps.importLibrary("core");
定数 | |
|---|---|
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 オブジェクトとして指定します。 |