DirectionsService クラス
google.maps.DirectionsService
クラス
2 つ以上の地点間のルートを計算するサービスです。
const {DirectionsService} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
DirectionsService |
DirectionsService() パラメータ: なし
ルートクエリを Google サーバーに送信する DirectionsService の新しいインスタンスを作成します。 |
Methods | |
---|---|
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」(厳密には「United Kingdom of Great Britain and Northern Ireland」(グレート ブリテンおよび北アイルランド連合王国)の法人)です。 |
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 の配列。各配列には、構成を構成する区間とステップに関する情報が含まれています。provideRouteAlternatives を true に設定して DirectionsRequest を作成しない限り、ルートは 1 つだけです。 |
available_travel_modes optional |
タイプ:
Array<TravelMode> optional 利用可能な移動手段の配列が格納されます。このフィールドは、リクエストで移動手段を指定していて、結果が得られなかった場合に返されます。配列には、指定された地点セットの国で使用できる移動手段が含まれます。1 つ以上の地点が「経由地点」である場合、このフィールドは返されません。 |
geocoded_waypoints optional |
タイプ:
Array<DirectionsGeocodedWaypoint> optional DirectionsGeocodedWaypoint の配列。各配列には出発地、目的地、地点のジオコーディングの情報が含まれています。 |
DirectionsRenderer クラス
google.maps.DirectionsRenderer
クラス
DirectionsService
から取得したルートをレンダリングします。
このクラスは MVCObject
を拡張します。
const {DirectionsRenderer} = await google.maps.importLibrary("routes")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) パラメータ:
指定されたオプションでレンダラを作成します。ルートは、地図上にビジュアル オーバーレイとしてレンダリングすることも、 <div> パネルにテキストによる指示としてレンダリングすることもできます。 |
Methods | |
---|---|
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
インターフェース
ジオコーディングされた 1 つの地点。
プロパティ | |
---|---|
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
内の区間のセットを含む 1 つのルート。このオブジェクトは「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 |
タイプ:
string Overview_path 内のルートをエンコードしたポリライン表現で表したもの。このポリラインは、結果のルートを近似した(平滑化した)経路です。 |
summary |
タイプ:
string ルートについての短いテキストでの説明を指定します。代替ルートに名前を付けたり、曖昧さをなくしたりするのに便利です。 |
warnings |
タイプ:
Array<string> これらのルートを示すときに表示される警告。 |
waypoint_order |
タイプ:
Array<number> optimizeWaypoints が true に設定されている場合、このフィールドには並べ替えられた入力地点の順列が含まれます。例:出発地: ロサンゼルス 地点: ダラス, バンガー, フェニックス 目的地: ニューヨーク で、最適化された出力が次の順序で表示された場合: 出発地: ロサンゼルス 地点: フェニックス、ダラス、バンガー 目的地: ニューヨーク 場合、このフィールドは [1, 0] で、値を含む 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 の配列。各配列には、この区間の個々のステップに関する情報が含まれています。 |
|
タイプ:
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
内の 1 つの 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 は、Places API への任意のリクエスト(TextSearch など)から取得できます。プレイス 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 アベニュー ローカル」)。 |
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
定数