- HTTP リクエスト
- リクエストの本文
- レスポンスの本文
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- ルート
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- ビューポート
- RouteLocalizedValues
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
一連の終点と中間地点を指定すると、メインルートとオプションの代替ルートが返されます。
注: このメソッドでは、入力でレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクを指定するには、URL パラメータ $fields または fields を使用するか、HTTP/gRPC ヘッダー X-Goog-FieldMask を使用します(使用可能な URL パラメータとヘッダーをご覧ください)。値は、フィールドパスのカンマ区切りのリストです。フィールドパスの作成方法に関する詳細なドキュメントをご覧ください。
たとえば、次のメソッドでは、
- 利用可能なすべてのフィールドのフィールド マスク(手動検査用):
X-Goog-FieldMask: * - ルートレベルの所要時間、距離、ポリラインのフィールド マスク(本番環境の設定例):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google では、ワイルドカード(*)レスポンス フィールド マスクの使用や、最上位(routes)でのフィールド マスクの指定は推奨していません。理由は次のとおりです。
- 必要なフィールドのみを選択すると、サーバーの計算サイクルが節約され、レイテンシを抑えて結果を返すことができます。
- 本番環境ジョブで必要なフィールドのみを選択すると、安定したレイテンシ パフォーマンスが確保されます。今後、レスポンス フィールドが追加される可能性があります。これらの新しいフィールドでは、追加の計算時間が必要になる場合があります。すべてのフィールドを選択した場合、または最上位レベルですべてのフィールドを選択した場合、追加された新しいフィールドが自動的にレスポンスに含まれるため、パフォーマンスが低下する可能性があります。
- 必要なフィールドのみを選択すると、レスポンス サイズが小さくなり、ネットワーク スループットが向上します。
HTTP リクエスト
POST https://routes.googleapis.com/directions/v2:computeRoutes
この URL は gRPC Transcoding 構文を使用します。
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "origin": { object ( |
| フィールド | |
|---|---|
origin |
必須。出発地のウェイポイント。 |
destination |
必須。目的地のウェイポイント。 |
intermediates[] |
省略可。ルート上のウェイポイント(終点を除く)のセット。停車地点または通過地点として使用します。最大 25 個の中間地点がサポートされています。 |
travelMode |
省略可。移動手段を指定します。 |
routingPreference |
省略可。ルートの計算方法を指定します。サーバーは、選択されたルーティング設定を使用してルートを計算しようとします。ルーティング設定でエラーが発生した場合、またはレイテンシが非常に長い場合は、エラーが返されます。このオプションは、 |
polylineQuality |
省略可。ポリラインの品質に関する設定を指定します。 |
polylineEncoding |
省略可。ポリラインの優先エンコードを指定します。 |
departureTime |
省略可。出発時刻。この値を設定しない場合、デフォルト値はリクエストを行った時刻になります。注: RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
arrivalTime |
省略可。到着時刻。注: リクエストで RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
computeAlternativeRoutes |
省略可。ルートに加えて代替ルートを計算するかどうかを指定します。中間地点があるリクエストの場合、代替ルートは返されません。 |
routeModifiers |
省略可。ルートの計算方法に影響する、満たすべき条件のセット。 |
languageCode |
省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。詳しくは、Unicode ロケール識別子をご覧ください。サポートされている言語の一覧については、言語のサポートをご覧ください。この値を指定しない場合、表示言語はルート リクエストの場所から推測されます。 |
regionCode |
省略可。地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。詳しくは、国別コード トップレベル ドメインをご覧ください。 |
units |
省略可。表示フィールドの測定単位を指定します。これらのフィールドには、 |
optimizeWaypointOrder |
省略可。true に設定すると、指定された中間ウェイポイントを並べ替えることで、ルートの全体的な費用を最小限に抑えようとします。中間地点のいずれかが |
requestedReferenceRoutes[] |
省略可。デフォルトのルートに加えて、リクエストの一部として計算する参照ルートを指定します。参照ルートは、デフォルト ルートとは異なるルート計算目標を持つルートです。たとえば、 |
extraComputations[] |
省略可。リクエストの完了に使用できる追加の計算のリスト。注: これらの追加の計算により、レスポンスに追加のフィールドが返されることがあります。これらの追加フィールドは、レスポンスで返されるフィールド マスクでも指定する必要があります。 |
trafficModel |
省略可。交通状況を考慮して所要時間を計算する際に使用する前提条件を指定します。この設定に応じて、 |
transitPreferences |
省略可。 |
レスポンスの本文
v2.computeRoutes レスポンス メッセージ。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "routes": [ { object ( |
| フィールド | |
|---|---|
routes[] |
|
fallbackInfo |
サーバーが入力されたすべての設定を使用してルート結果を計算できない場合、別の計算方法にフォールバックすることがあります。フォールバック モードが使用されている場合、このフィールドにはフォールバック レスポンスに関する詳細情報が含まれます。それ以外の場合、このフィールドは設定されません。 |
geocodingResults |
住所として指定されたウェイポイントのジオコーディング レスポンス情報が含まれます。 |
PolylineQuality
ポリラインの品質を指定する値のセット。
| 列挙型 | |
|---|---|
POLYLINE_QUALITY_UNSPECIFIED |
ポリラインの品質設定が指定されていません。デフォルトは OVERVIEW です。 |
HIGH_QUALITY |
高品質のポリラインを指定します。これは、OVERVIEW よりも多くのポイントを使用して構成されますが、レスポンス サイズが増加します。より高い精度が必要な場合は、この値を使用します。 |
OVERVIEW |
概要ポリラインを指定します。これは少数のポイントで構成されます。この値は、ルートの概要を表示するときに使用します。このオプションを使用すると、HIGH_QUALITY オプションを使用する場合よりもリクエスト レイテンシが低くなります。 |
PolylineEncoding
返されるポリラインの優先タイプを指定します。
| 列挙型 | |
|---|---|
POLYLINE_ENCODING_UNSPECIFIED |
ポリライン タイプの優先度が指定されていません。デフォルトは ENCODED_POLYLINE です。 |
ENCODED_POLYLINE |
ポリライン エンコード アルゴリズムを使用してエンコードされたポリラインを指定します。 |
GEO_JSON_LINESTRING |
GeoJSON LineString 形式を使用してポリラインを指定します。 |
ReferenceRoute
ComputeRoutesRequest でサポートされている参照ルート。
| 列挙型 | |
|---|---|
REFERENCE_ROUTE_UNSPECIFIED |
使用されません。この値を含むリクエストは失敗します。 |
FUEL_EFFICIENT |
燃料効率が良いルート。 |
SHORTER_DISTANCE |
移動距離が短いルート。この機能は試験運用中です。
この機能は、他の移動手段、経由地、 |
ExtraComputation
リクエストの完了時に実行する追加の計算。今後、値が追加される可能性があります。
| 列挙型 | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
使用されません。この値を含むリクエストは失敗します。 |
TOLLS |
ルートの通行料金情報。 |
FUEL_CONSUMPTION |
ルートの推定燃料消費量。 |
TRAFFIC_ON_POLYLINE |
ルートのトラフィック アウェア ポリライン。 |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction。書式設定された HTML テキスト文字列として表示されます。このコンテンツはそのまま読み取られます。このコンテンツは表示のみを目的としています。プログラムで解析しないでください。 |
FLYOVER_INFO_ON_POLYLINE |
ルートのフライオーバー情報。この情報を返すには、routes.polyline_details.flyover_info フィールドマスクを指定する必要があります。現在、このデータはインドの一部の都市圏でのみ入力されます。この機能は試験運用版であり、SKU / 料金は変更される可能性があります。 |
NARROW_ROAD_INFO_ON_POLYLINE |
ルートの狭い道路に関する情報。この情報を返すには、routes.polyline_details.narrow_road_info フィールドマスクを指定する必要があります。現在、このデータはインドの一部の都市圏でのみ入力されます。この機能は試験運用版であり、SKU / 料金は変更される可能性があります。 |
TUNNEL_INFO_ON_POLYLINE |
ルートのトンネル情報。この情報を返すには、routes.polyline_details.tunnel_info フィールドマスクを指定する必要があります。 |
BRIDGE_INFO_ON_POLYLINE |
ルートの橋に関する情報。この情報を返すには、routes.polyline_details.bridge_info フィールドマスクを指定する必要があります。 |
SKYWAY_INFO_ON_POLYLINE |
ルートのスカイウェイ情報。この情報を返すには、routes.polyline_details.skyway_info フィールドマスクを指定する必要があります。 |
ルーティング
ルートが含まれます。ルートは、始点、終点、中間地点を結ぶ一連の接続された道路セグメントで構成されます。
| JSON 表現 |
|---|
{ "routeLabels": [ enum ( |
| フィールド | |
|---|---|
routeLabels[] |
|
legs[] |
ルートを構成する区間(ウェイポイント間のパスセグメント)のコレクション。各区間は、 |
distanceMeters |
ルートの移動距離(メートル単位)。 |
duration |
ルートの移動に必要な時間。
それ以外の場合は、
|
staticDuration |
交通状況を考慮しない、ルートの移動時間。
|
polyline |
ルート全体のポリライン。このポリラインは、すべての |
description |
ルートの説明。 |
warnings[] |
ルートを表示するときに表示する警告の配列。 |
viewport |
ポリラインのビューポート境界ボックス。 |
travelAdvisory |
ルートに関する追加情報。 |
optimizedIntermediateWaypointIndex[] |
|
localizedValues |
|
routeToken |
ナビゲーション中にルートを再構築するために Navigation SDK に渡すことができる不透明なトークン。ルート変更が発生した場合は、ルート作成時の元の意図を尊重します。このトークンは不透明な blob として扱います。サービスがまったく同じルートを返しても、値が変更される可能性があるため、リクエスト間で値を比較しないでください。 注: |
polylineDetails |
ポリラインに沿った詳細情報が含まれます。 |
RouteLabel
のラベル。他のルートと比較するために、ルートの特定のプロパティを識別するのに役立ちます。Route
| 列挙型 | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
デフォルト - 使用されません。 |
DEFAULT_ROUTE |
ルート計算で返されるデフォルトの「最適な」ルート。 |
DEFAULT_ROUTE_ALTERNATE |
デフォルトの「最適な」ルートの代替ルート。 が指定されている場合、このようなルートが返されます。 |
FUEL_EFFICIENT |
燃料効率が良いルート。この値のラベルが付いたルートは、燃料消費量などのエコ パラメータに最適化されていると判断されます。 |
SHORTER_DISTANCE |
移動距離が短いルート。この機能は試験運用中です。 |
RouteLeg
via 以外のウェイポイント間のセグメントが含まれています。
| JSON 表現 |
|---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
| フィールド | |
|---|---|
distanceMeters |
ルート区間の移動距離(メートル単位)。 |
duration |
区間の移動に必要な時間。
それ以外の場合は、
|
staticDuration |
区間の移動時間。交通状況を考慮せずに計算されます。
|
polyline |
各 |
startLocation |
この区間の開始位置。このロケーションは、指定された |
endLocation |
この区間の終了地点。このロケーションは、指定された |
steps[] |
この区間内のセグメントを示すステップの配列。各ステップは 1 つのナビゲーション指示を表します。 |
travelAdvisory |
ルート区間に関する、ユーザーに通知する必要がある追加情報(交通規制の可能性など)が含まれます。 |
localizedValues |
|
stepsOverview |
この |
ポリライン
エンコードされたポリラインをカプセル化します。
| JSON 表現 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| フィールド | |
|---|---|
| ポリラインのタイプをカプセル化します。デフォルトは encoded_polyline です。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。 | |
encodedPolyline |
ポリライン エンコード アルゴリズムを使用したポリラインの文字列エンコード |
geoJsonLinestring |
GeoJSON LineString 形式を使用してポリラインを指定します。 |
| 相互に排他的なフィールドの終了。 | |
RouteLegStep
のセグメントが含まれます。ステップは、1 つのナビゲーション指示に対応します。ルート区間はステップで構成されます。RouteLeg
| JSON 表現 |
|---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
| フィールド | |
|---|---|
distanceMeters |
このステップの移動距離(メートル単位)。状況によっては、このフィールドに値が設定されないことがあります。 |
staticDuration |
交通状況を考慮しない、このステップの移動時間。状況によっては、このフィールドに値が設定されないことがあります。
|
polyline |
このステップに関連付けられたポリライン。 |
startLocation |
このステップの開始位置。 |
endLocation |
このステップの終了位置。 |
navigationInstruction |
ナビゲーションの手順。 |
travelAdvisory |
区間のステップで、ユーザーに通知する必要がある追加情報(交通規制区域の制限など)が含まれます。 |
localizedValues |
|
transitDetails |
移動手段が |
travelMode |
このステップで使用される移動手段。 |
Maneuver
現在のステップで実行するナビゲーション アクション(左折、合流、直進など)を指定する値のセット。
| 列挙型 | |
|---|---|
MANEUVER_UNSPECIFIED |
使用されません。 |
TURN_SLIGHT_LEFT |
少し左を向いてください。 |
TURN_SHARP_LEFT |
左に急カーブします。 |
UTURN_LEFT |
左折して U ターンします。 |
TURN_LEFT |
左折する。 |
TURN_SLIGHT_RIGHT |
少し右を向いてください。 |
TURN_SHARP_RIGHT |
右に急カーブします。 |
UTURN_RIGHT |
右に U ターンします。 |
TURN_RIGHT |
右折する。 |
STRAIGHT |
直進する。 |
RAMP_LEFT |
左側のランプに入る。 |
RAMP_RIGHT |
右側のランプに入る。 |
MERGE |
交通の流れに合流する。 |
FORK_LEFT |
左側の分岐を進みます。 |
FORK_RIGHT |
右の分岐を進みます。 |
FERRY |
フェリーに乗ります。 |
FERRY_TRAIN |
フェリーに乗り入れる列車に乗る。 |
ROUNDABOUT_LEFT |
ロータリーで左折します。 |
ROUNDABOUT_RIGHT |
ロータリーで右折します。 |
DEPART |
最初の操作。 |
NAME_CHANGE |
道路名の変更を示すために使用します。 |
DESTINATION |
目的地への到着を示すために使用されます。 |
RouteLegStepTravelAdvisory
区間のステップで交通規制が適用される可能性があるなど、ユーザーに通知する必要がある追加情報が含まれます。
| JSON 表現 |
|---|
{
"speedReadingIntervals": [
{
object ( |
| フィールド | |
|---|---|
speedReadingIntervals[] |
注: このフィールドは現在使用されていません。 |
RouteLegStepLocalizedValues
特定のプロパティのテキスト表現。
| JSON 表現 |
|---|
{ "distance": { object ( |
| フィールド | |
|---|---|
distance |
テキスト形式で表される移動距離。 |
staticDuration |
交通状況を考慮しない所要時間(テキスト形式)。 |
RouteLegStepTransitDetails
TRANSIT ルートに関連する RouteLegStep の追加情報。
| JSON 表現 |
|---|
{ "stopDetails": { object ( |
| フィールド | |
|---|---|
stopDetails |
ステップの到着停車地と出発停車地に関する情報。 |
localizedValues |
|
headsign |
車両または出発駅に示されている、この路線を進む方向を指定します。多くの場合、この行先は終点に相当します。 |
headway |
現時点での同じ駅や停留所からの出発間隔を推定時間として指定します。たとえば、運行間隔が 600 秒の場合、バスを逃すと 10 分待つことになると予想されます。
|
transitLine |
このステップで使用される交通機関の路線に関する情報。 |
stopCount |
出発地から到着地までの停車回数。この数には到着停車地は含まれますが、出発停車地は含まれません。たとえば、停車地 A から出発して、停車地 B と C を経由し、停車地 D に到着するルートの場合、 |
tripShortText |
乗客が交通機関のルートを識別できるように、時刻表や案内板に表示されるテキスト。このテキストは、運行日の特定のルートを一意に識別するものである必要があります。たとえば、「538」は、平日の 15:10 にカリフォルニア州サンノゼを出発してカリフォルニア州サクラメントに向かうアムトラックの列車の |
TransitStopDetails
RouteLegStep の停車地に関する詳細。
| JSON 表現 |
|---|
{ "arrivalStop": { object ( |
| フィールド | |
|---|---|
arrivalStop |
ステップの到着停留所に関する情報。 |
arrivalTime |
ステップの予定到着時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
departureStop |
ステップの出発停留所に関する情報。 |
departureTime |
ステップの出発予定時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
TransitStop
交通機関の駅に関する情報。
| JSON 表現 |
|---|
{
"name": string,
"location": {
object ( |
| フィールド | |
|---|---|
name |
交通機関の停留所の名前。 |
location |
停留所の位置を緯度と経度の座標で表します。 |
TransitDetailsLocalizedValues
RouteTransitDetails の値のローカライズされた説明。
| JSON 表現 |
|---|
{ "arrivalTime": { object ( |
| フィールド | |
|---|---|
arrivalTime |
対応するタイムゾーンを含む、フォーマットされたテキスト表現の時刻。 |
departureTime |
対応するタイムゾーンを含む、フォーマットされたテキスト表現の時刻。 |
LocalizedTime
ローカライズされた時刻の説明。
| JSON 表現 |
|---|
{
"time": {
object ( |
| フィールド | |
|---|---|
time |
指定されたタイムゾーンの文字列として指定された時刻。 |
timeZone |
タイムゾーンが含まれます。この値は、IANA タイムゾーン データベースで定義されたタイムゾーンの名前です(例: America/New_York)。 |
TransitLine
このステップで使用される交通機関の路線に関する情報が含まれます。
| JSON 表現 |
|---|
{ "agencies": [ { object ( |
| フィールド | |
|---|---|
agencies[] |
この交通機関の路線を運営する交通機関。 |
name |
この路線の正式名称(例: 「8 Avenue Local」)。 |
uri |
交通機関運営者が提供している、この交通機関の路線の URI。 |
color |
この路線の表記に通常使用される色。16 進数で表されます。 |
iconUri |
この路線に関連付けられたアイコンの URI。 |
nameShort |
この路線の略称。この名前は通常、「M7」や「355」などの路線番号です。 |
textColor |
この路線の表記に通常使用されるテキストの色。16 進数で表されます。 |
vehicle |
この交通機関の路線で運行される車両のタイプ。 |
TransitAgency
交通機関の路線を運営する交通機関。
| JSON 表現 |
|---|
{ "name": string, "phoneNumber": string, "uri": string } |
| フィールド | |
|---|---|
name |
この交通機関の名前。 |
phoneNumber |
交通機関の電話番号(国際電話形式)。 |
uri |
交通機関の URI。 |
TransitVehicle
交通機関のルートで使用される車両に関する情報。
| JSON 表現 |
|---|
{ "name": { object ( |
| フィールド | |
|---|---|
name |
この車両の名前(大文字)。 |
type |
使用された車両のタイプ。 |
iconUri |
この車両タイプに関連付けられたアイコンの URI。 |
localIconUri |
地域の交通標識に基づき、乗り物の種別に関連付けられたアイコンの URI。 |
TransitVehicleType
交通機関の経路の車両タイプ。
| 列挙型 | |
|---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
未使用。 |
BUS |
バス。 |
CABLE_CAR |
ケーブルによって、通常は地上を走る車両。空中ケーブルカーは、タイプ GONDOLA_LIFT に入ることもあります。 |
COMMUTER_TRAIN |
通勤列車。 |
FERRY |
フェリー。 |
FUNICULAR |
険しい斜面をケーブルで引っ張る乗り物。ケーブルカーは一般的に 2 両編成で、車両は互いに重量のバランスを取ります。 |
GONDOLA_LIFT |
空中ケーブルカー。 |
HEAVY_RAIL |
ヘビーレール。 |
HIGH_SPEED_TRAIN |
高速列車。 |
INTERCITY_BUS |
長距離バス。 |
LONG_DISTANCE_TRAIN |
長距離列車。 |
METRO_RAIL |
ライトレール トランジット。 |
MONORAIL |
モノレール。 |
OTHER |
その他の車両。 |
RAIL |
鉄道。 |
SHARE_TAXI |
乗合タクシーは、ルート上のどこでも乗客が乗り降りできるバスの一種です。 |
SUBWAY |
地下を走るライトレール。 |
TRAM |
地上を走るライトレール。 |
TROLLEYBUS |
トロリーバス。 |
RouteLegTravelAdvisory
区間のステップでユーザーに通知する必要がある追加情報(交通規制の可能性など)が含まれます。
| JSON 表現 |
|---|
{ "tollInfo": { object ( |
| フィールド | |
|---|---|
tollInfo |
特定の |
speedReadingIntervals[] |
交通密度を示す速度測定間隔。このフィールドは、リクエストに 例: |
RouteLegLocalizedValues
特定のプロパティのテキスト表現。
| JSON 表現 |
|---|
{ "distance": { object ( |
| フィールド | |
|---|---|
distance |
テキスト形式で表される移動距離。 |
duration |
テキスト形式で表され、クエリの地域にローカライズされた所要時間。交通状況を考慮します。注: 交通情報をリクエストしなかった場合、この値は staticDuration と同じ値になります。 |
staticDuration |
交通状況を考慮しない所要時間(テキスト形式)。 |
StepsOverview
RouteLegStep のリストに関する概要情報を提供します。
| JSON 表現 |
|---|
{
"multiModalSegments": [
{
object ( |
| フィールド | |
|---|---|
multiModalSegments[] |
|
MultiModalSegment
RouteLeg.steps のさまざまなマルチモーダル セグメントに関する概要情報を提供します。マルチモーダル セグメントは、同じ RouteTravelMode を持つ 1 つ以上の連続する RouteLegStep として定義されます。RouteLeg のステップにマルチモーダル セグメントが含まれていない場合、このフィールドは入力されません。
| JSON 表現 |
|---|
{ "navigationInstruction": { object ( |
| フィールド | |
|---|---|
navigationInstruction |
マルチモーダル セグメントの NavigationInstruction。 |
travelMode |
マルチモーダル セグメントの移動手段。 |
stepStartIndex |
マルチモーダル セグメントの開始点となる、対応する |
stepEndIndex |
マルチモーダル セグメントの終了を示す対応する |
ビューポート
緯度と経度のビューポート。対角線上にある 2 つの low ポイントと high ポイントで表されます。ビューポートは閉じた領域と見なされます。つまり、境界が含まれます。緯度の範囲は -90 ~ 90 度、経度の範囲は -180 ~ 180 度にする必要があります。さまざまなケースがあります。
low=highの場合、ビューポートはその 1 つのポイントで構成されます。low.longitude>high.longitudeの場合、経度の範囲は反転します(ビューポートは経度 180 度の線をまたぎます)。low.longitude= -180 度、high.longitude= 180 度の場合、ビューポートにはすべての経度が含まれます。low.longitude= 180 度、high.longitude= -180 度の場合、経度範囲は空になります。low.latitude>high.latitudeの場合、緯度範囲は空です。
low と high の両方に値を入力する必要があり、表されるボックスを空にすることはできません(上記の定義で指定されているとおり)。ビューポートが空の場合、エラーが発生します。
たとえば、次のビューポートはニューヨーク市を完全に囲んでいます。
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
| JSON 表現 |
|---|
{ "low": { object ( |
| フィールド | |
|---|---|
low |
必須。ビューポートの最下点。 |
high |
必須。ビューポートの最高点。 |
RouteLocalizedValues
特定のプロパティのテキスト表現。
| JSON 表現 |
|---|
{ "distance": { object ( |
| フィールド | |
|---|---|
distance |
テキスト形式で表される移動距離。 |
duration |
テキスト形式で表され、クエリの地域にローカライズされた所要時間。交通状況を考慮します。注: 交通情報をリクエストしなかった場合、この値は |
staticDuration |
交通状況を考慮しない所要時間(テキスト形式)。 |
transitFare |
テキスト形式で表された交通機関の運賃。 |
PolylineDetails
ポリラインの特定のインデックスまたは連続するセグメントに対応する詳細。ポイント P_0、P_1、...、P_N(0 から始まるインデックス)を持つポリラインが指定されている場合、PolylineDetails は間隔と関連するメタデータを定義します。
| JSON 表現 |
|---|
{ "tunnelInfo": [ { object ( |
| フィールド | |
|---|---|
tunnelInfo[] |
ポリラインに沿ったトンネルの詳細。このフィールドは、リクエストで |
restrictionInfo[] |
ポリラインに沿った制限の詳細。このフィールドは、リクエストで |
flyoverInfo[] |
ポリラインに沿ったフライオーバーの詳細。 |
narrowRoadInfo[] |
ポリラインに沿った狭い道路の詳細。 |
bridgeInfo[] |
ポリラインに沿った橋の詳細。 |
skywayInfo[] |
ポリラインに沿ったスカイウェイの詳細。 |
TunnelInfo
ポリラインに沿ったトンネルに関する情報をカプセル化します。
| JSON 表現 |
|---|
{ "tunnelPresence": enum ( |
| フィールド | |
|---|---|
tunnelPresence |
ポリラインの特定の区間にトンネルが存在するかどうかを示します。 |
polylinePointIndex |
ポリラインに沿ったトンネル関連情報の位置。 |
RoadFeatureState
ポリラインの区間に沿った道路地物の状態をカプセル化します。
| 列挙型 | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
道路対象物の状態が計算されませんでした(デフォルト値)。 |
EXISTS |
道路構造物が存在する。 |
DOES_NOT_EXIST |
道路対象物が存在しない。 |
PolylinePointIndex
ポリラインの詳細の開始インデックスと終了インデックスをカプセル化します。データが単一のポイントに対応する場合、startIndex と endIndex は等しくなります。
| JSON 表現 |
|---|
{ "startIndex": integer, "endIndex": integer } |
| フィールド | |
|---|---|
startIndex |
ポリライン内のこの詳細の開始インデックス。 |
endIndex |
ポリライン内のこの詳細の終了インデックス。 |
RestrictionInfo
ポリラインに沿ったさまざまな制限に関する情報をカプセル化します。
| JSON 表現 |
|---|
{ "restrictionPresence": enum ( |
| フィールド | |
|---|---|
restrictionPresence |
出力専用。ポリラインの特定の区間に制限があるかどうかを示します。 |
polylinePointIndex |
ポリラインに沿った制限関連情報の位置。 |
| ポリラインの特定の区間に適用できる制限の種類をカプセル化します。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。 | |
restrictedHeightMm |
高さ制限(ミリメートル単位)。このフィールドは、高さ制限により指定された車両が通行できない場合や、クリアランスが低い場合に設定されます。 |
restrictedWeightKg |
重量制限(kg)。このフィールドは、重量制限により通行が妨げられている場合、または指定された車両の重量に近い場合に設定されます。 |
hazardousGoods |
このフィールドは、危険物の運搬が制限されている場合に true に設定されます。 |
trucksProhibited |
このフィールドは、トラックが禁止されている場合に true に設定されます。 |
| 相互に排他的なフィールドの終了。 | |
FlyoverInfo
ポリラインに沿ったフライオーバーに関する情報をカプセル化します。
| JSON 表現 |
|---|
{ "flyoverPresence": enum ( |
| フィールド | |
|---|---|
flyoverPresence |
出力専用。ポリラインの特定の区間にフライオーバーが存在するかどうかを示します。 |
polylinePointIndex |
ポリラインに沿ったフライオーバー関連情報の位置。 |
NarrowRoadInfo
ポリラインに沿った狭い道路に関する情報をカプセル化します。
| JSON 表現 |
|---|
{ "narrowRoadPresence": enum ( |
| フィールド | |
|---|---|
narrowRoadPresence |
出力専用。ポリラインの特定の区間に狭い道路があるかどうかを示します。 |
polylinePointIndex |
ポリラインに沿った狭い道路に関連する情報の位置。 |
BridgeInfo
ポリラインに沿った橋に関する情報をカプセル化します。
| JSON 表現 |
|---|
{ "bridgePresence": enum ( |
| フィールド | |
|---|---|
bridgePresence |
ポリラインの特定の区間に橋が存在するかどうかを示します。 |
polylinePointIndex |
ポリラインに沿った橋梁関連情報の位置。 |
SkywayInfo
ポリラインに沿ったスカイウェイに関する情報をカプセル化します。
| JSON 表現 |
|---|
{ "skywayPresence": enum ( |
| フィールド | |
|---|---|
skywayPresence |
ポリラインの特定の区間にスカイウェイが存在するかどうかを示します。 |
polylinePointIndex |
ポリラインに沿ったスカイウェイ関連情報の位置。 |
GeocodingResults
出発地、目的地、中間地点の が含まれます。住所のウェイポイントにのみ入力されます。GeocodedWaypoints
| JSON 表現 |
|---|
{ "origin": { object ( |
| フィールド | |
|---|---|
origin |
出発地のジオコーディングされたウェイポイント。 |
destination |
目的地のジオコーディングされたウェイポイント。 |
intermediates[] |
ジオコーディングされた中間地点のリスト。各地点には、リクエストで指定された順序で、地点の 0 から始まる位置に対応するインデックス フィールドが含まれます。 |
GeocodedWaypoint
経由地として使用される場所の詳細。住所のウェイポイントにのみ入力されます。住所がどのようにジオコーディングされたかを判断するための、ジオコーディング結果の詳細が含まれます。
| JSON 表現 |
|---|
{
"geocoderStatus": {
object ( |
| フィールド | |
|---|---|
geocoderStatus |
ジオコーディングの処理結果を示すステータス コードです。 |
type[] |
結果の型。0 個以上の型タグの形式で指定します。サポートされているタイプ: 住所タイプと住所コンポーネントのタイプ。 |
partialMatch |
ジオコーダによって、元のリクエストに完全一致する住所は見つからなかったものの、部分一致する住所は見つかったことを示します。元のリクエストで住所の表記が間違っていたり、不完全である可能性があります。 |
placeId |
この結果のプレイス ID。 |
intermediateWaypointRequestIndex |
リクエスト内の対応する中間ウェイポイントのインデックス。対応するウェイポイントが中間ウェイポイントの場合にのみ入力されます。 |