DirectionsService クラス
google.maps.DirectionsService
クラス
2 つ以上の地点間のルートを計算するサービスです。
v=beta
を使用している場合は、const {DirectionsService} = await google.map.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 ジオコーディング リクエストのバイアスとして使われる地域コード。地域コードは 2 文字の ccTLD(「トップレベル ドメイン」)を受け入れます。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、イギリスの ccTLD は「uk」( .co.uk )ですが、ISO 3166-1 コードは「gb」(技術的には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ)です。 |
transitOptions optional |
タイプ:
TransitOptions optional travelMode が交通機関であるリクエストにのみ適用される設定です。このオブジェクトは、他の移動手段には影響しません。 |
unitSystem optional |
タイプ:
UnitSystem optional デフォルト: 原産国で使用されている単位系。
距離を表示する際に使用される、優先単位系。 |
waypoints optional |
タイプ:
Array<DirectionsWaypoint> optional 中間地点の配列。出発地から目的地までのルートは、この配列内の各地点に基づいて計算されます。指定できる地点の最大数については、デベロッパー ガイドをご覧ください。地点は乗換案内では利用できません。省略可。 |
DirectionsStatus 定数
google.maps.DirectionsStatus
定数
route()
の呼び出しの完了時に DirectionsService
から返されるステータス。値または定数名を使用して指定します。たとえば、'OK'
や google.maps.DirectionsStatus.OK
です。
v=beta
を使用している場合は、const {DirectionsStatus} = await google.map.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 ではありません。
プロパティ | |
---|---|
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
を拡張します。
v=beta
を使用している場合は、const {DirectionsRenderer} = await google.map.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 オブジェクトによって使用されている現在の(0 から始まる)ルート インデックスを返します。 |
setDirections |
setDirections(directions) パラメータ:
戻り値: None
DirectionsService からの結果を使用するようにレンダラを設定します。この方法でルートの有効なセットを設定すると、レンダラの指定した地図とパネルにルートが表示されます。 |
setMap |
setMap(map) パラメータ:
戻り値: None
このメソッドでは、ルートをレンダリングする地図を指定します。 null を渡して、地図から経路を削除します。 |
setOptions |
setOptions(options) パラメータ:
戻り値: None
初期化後、この DirectionsRenderer のオプション設定を変更します。 |
setPanel |
setPanel(panel) パラメータ:
戻り値: None
このメソッドは、 <div> でルートをレンダリングします。null をパネルから削除して、コンテンツを削除します。 |
setRouteIndex |
setRouteIndex(routeIndex) パラメータ:
戻り値: None
レンダリングする DirectionsResult オブジェクトのルートの(0 から始まる)インデックスを設定します。デフォルトでは、配列内の最初のルートがレンダリングされます。 |
継承:
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 デベロッパー ガイドをご覧ください。 |
types optional |
タイプ:
Array<string> optional 返されるジオコードされた要素のタイプを示す文字列の配列。使用可能な文字列のリストについては、デベロッパー ガイドの住所コンポーネントのタイプをご覧ください。 |
DirectionsRoute インターフェース
google.maps.DirectionsRoute
インターフェース
DirectionsResult
に一連の区間を含む単一のルート。このオブジェクトは「JSON に類似した形式」ですが、LatLng
オブジェクトが直接的および間接的に含まれているため、厳密には JSON ではありません。
プロパティ | |
---|---|
bounds |
タイプ:
LatLngBounds このルートの境界。 |
copyrights |
タイプ:
string このルートに表示される著作権テキスト。 |
legs |
タイプ:
Array<DirectionsLeg> DirectionsLeg の配列。構成の各ステップに関する情報が含まれます。指定した立ち寄り地点や目的地には、区間が 1 つずつあります。そのため、立ち寄り地点のないルートには 1 つの DirectionsLeg が含まれ、立ち寄り地点が 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 に設定されている場合、このフィールドには、順序付けされた入力地点の順列が含まれます。たとえば、入力が「」の場合: 出発地: ロサンゼルス 地点: ダラス、バンガー、フェニックス 目的地: ニューヨーク 最適化された出力は次のように並べ替えられます。 出発地: ロサンゼルス 地点: フェニックス、ダラス、 目的地: ニューヨーク の場合、このフィールドは [2, 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
内の 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
です。
v=beta
を使用している場合は、const {TravelMode} = await google.map.importLibrary("routes")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BICYCLING |
自転車ルート リクエストを指定します。 |
DRIVING |
運転ルート リクエストを指定します。 |
TRANSIT |
乗換案内リクエストを指定します。 |
WALKING |
徒歩ルート リクエストを指定します。 |
DRIVEOptions インターフェース
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
です。
v=beta
を使用している場合は、const {TrafficModel} = await google.map.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 オブジェクトは、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
です。
v=beta
を使用している場合は、const {TransitMode} = await google.map.importLibrary("routes")
を呼び出してアクセスできます。詳しくは、Maps JavaScript API のライブラリをご覧ください。
定数 | |
---|---|
BUS |
優先する移動手段としてバスを指定します。 |
RAIL |
優先する移動手段として鉄道を指定します。 |
SUBWAY |
優先する移動手段として地下鉄を指定します。 |
TRAIN |
優先する移動手段として電車を指定します。 |
TRAM |
路面電車を優先移動手段として指定します。 |
TransitRoutePreference 定数
google.maps.TransitRoutePreference
定数
TransitOptions
で指定できる有効な交通機関のルートタイプ。値または定数名を使用して指定します。たとえば、'LESS_WALKING'
や google.maps.TransitRoutePreference.LESS_WALKING
です。
v=beta
を使用している場合は、const {TransitRoutePreference} = await google.map.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 このタイプの交通機関の名前(「電車」や「バス」など)。 |
type |
タイプ:
VehicleType 使用した車両の種類(電車、バス、フェリーなど)。 |
VehicleType 定数
google.maps.VehicleType
定数
車両タイプで使用可能な値。
v=beta
を使用している場合は、const {VehicleType} = await google.map.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
で指定できる有効な単位系。
v=beta
を使用している場合は、const {UnitSystem} = await google.map.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 秒単位の所要時間。 |
時間インターフェース
google.maps.Time
インターフェース
日付オブジェクト、ローカライズされた文字列、タイムゾーンとしての時刻の表示。
プロパティ | |
---|---|
text |
タイプ:
string 時刻の値を表す文字列。この時刻は、交通機関の停止地点におけるタイムゾーンで表示されます。 |
time_zone |
タイプ:
string この停車地のタイムゾーン。この値は IANA タイムゾーン データベースで定義されているタイムゾーンの名前です(例: America/New_York)。 |
value |
タイプ:
Date この出発時刻または到着時刻。JavaScript の日付オブジェクトとして指定します。 |
DirectionsTravelMode 定数
google.maps.DirectionsTravelMode
定数
DirectionsUnitSystem 定数
google.maps.DirectionsUnitSystem
定数