Route - Get Route Range

  • リファレンス
Service:
Maps
API Version:
1.0

時間、距離、または燃料容量に基づいて、特定のしきい値内の特定のポイントからアクセスできる領域を示すマップを作成するために使用します。

Get Route Range (Isochrone) API は、指定された燃料、エネルギー、時間、または距離の予算に基づいて、原点から到達できる一連の場所を計算する HTTP GET 要求です。 ポリゴン境界 (または等時線) は、原点の結果である正確なポリゴン中心と同様に、反時計回りの方向で返されます。

返される多角形は、Search Inside Geometry などの処理を行って、指定された等時線内の POI を検索するために使用できます。

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
With optional parameters: 
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

URI パラメーター

名前 / 必須 型 説明
format
 path True

ResponseFormat

応答の目的の形式。 値には json または xml を指定できます。
api-version
 query True

string

Azure Maps API のバージョン番号。
query
 query True

number[]

範囲の計算を開始する座標。
accelerationEfficiency
 query

number

double

車両が加速したときに燃料に格納されている化学エネルギーを運動エネルギーに変換する効率を指定します (例: KineticEnergyGained/ChemicalEnergyConsumed)。ChemicalEnergyConsumed は、 fuelEnergyDensityInMJoulesPerLiter を使用して、消費された燃料を化学エネルギーに変換することによって得られます。

減速効率と組み合わせて使用 する必要があります。

使用できる値の範囲は、0.0 から 1/減速効率です。

良識値 : 燃焼モデル の場合 : 0.33, 電気モデル : 0.66
auxiliaryPowerInkW
 query

number

double

補助システムを維持するために消費される電力の量をキロワット (kW) 単位で指定します。

ACシステム、無線、暖房などのデバイスやシステムによる消費を指定するために使用できます。

賢明な値: 1.7
auxiliaryPowerInLitersPerHour
 query

number

double

車両の補助システムを維持するために消費される燃料の量を 1 時間あたりのリットル単位で指定します。

ACシステム、無線、暖房などのデバイスやシステムによる消費を指定するために使用できます。

賢明な値: 0.2
avoid
 query

RouteAvoidType[]

ルートの決定時にルート計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。 ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。
constantSpeedConsumptionInkWhPerHundredkm
 query

string

消費の速度に依存するコンポーネントを指定します。

速度と消費レートのペアの順序なしのリストとして提供されます。 この一覧では、消費曲線上のポイントを定義します。 一覧にない速度の従量課金レートは次のとおりです。

  • 線形補間によって、指定された速度がリスト内の 2 つの速度の間にある場合

  • それ以外の場合は線形外挿によって、リスト内の最も近い 2 つのポイントによって決定される定数 (ΔConsumption/ΔSpeed) を想定します

リストには 1 ~ 25 ポイント (両端を含む) が含まれている必要があり、同じ速度の重複するポイントが含まれていない可能性があります。 1 つのポイントのみが含まれている場合は、そのポイントの消費率がそれ以上処理されずに使用されます。

最大速度に対して指定される消費量は、最後の最大速度以上である必要があります。 これにより、外挿によって消費率がマイナスにならないことが保証されます。

同様に、一覧の 2 つの最小速度に対して指定された従量課金の値は、速度が小さい場合に負の消費率を招くことはできません。

消費値 (kWh/100km で表される) の有効な範囲は、0.01 から 100000.0 の間です。

賢明な値: 50,8.2:130,21.3

このパラメーターは、 電力消費モデルに必要です。
constantSpeedConsumptionInLitersPerHundredkm
 query

string

消費の速度に依存するコンポーネントを指定します。

コロンで区切られた速度 & 従量課金制ペアの順序なしのリストとして提供されます。 この一覧では、消費曲線上のポイントを定義します。 一覧にない速度の従量課金レートは次のとおりです。

  • 線形補間によって、指定された速度がリスト内の 2 つの速度の間にある場合

  • それ以外の場合は線形外挿によって、リスト内の最も近い 2 つのポイントによって決定される定数 (ΔConsumption/ΔSpeed) を想定します

リストには 1 ~ 25 ポイント (両端を含む) が含まれている必要があり、同じ速度の重複するポイントが含まれていない可能性があります。 1 つのポイントのみが含まれている場合は、そのポイントの消費率がそれ以上処理されずに使用されます。

最大速度に対して指定される消費量は、最後の最大速度以上である必要があります。 これにより、外挿によって消費率がマイナスにならないことが保証されます。

同様に、一覧の 2 つの最小速度に対して指定された従量課金の値は、速度が小さい場合に負の消費率を招くことはできません。

従量課金値 (l/100km で表される) の有効な範囲は、0.01 から 100000.0 の間です。

賢明な値: 50,6.3:130,11.5

注 : このパラメーターは 、燃焼消費モデルに必要です。
currentChargeInkWh
 query

number

double

現在の電力供給量をキロワット時 (kWh) 単位で指定します。

このパラメーターは maxChargeInkWh パラメーターと共に存在します。

使用できる値の範囲は、0.0 ~ maxChargeInkWh です。

賢明な値: 43
currentFuelInLiters
 query

number

double

燃料の現在の供給量をリットル単位で指定します。

賢明な値: 55
decelerationEfficiency
 query

number

double

車両が減速した場合 (つまり、ChemicalEnergySaved/KineticEnergyLost)、運動エネルギーを節約 (消費されない) 燃料に変換する効率を指定します。ChemicalEnergySaved は、 fuelEnergyDensityInMJoulesPerLiter を使用して、保存された (消費されていない) 燃料をエネルギーに変換することによって取得されます。

accelerationEfficiency とペアにする必要があります。

使用できる値の範囲は、0.0 ~ 1/accelerationEfficiency です。

良識値: 燃焼モデル の場合: 0.83、 電気モデル の場合: 0.91
departAt
 query

string

date-time

RFC 3339 セクション 5.6 で定義されている値としてdateTime書式設定された、任意のタイム ゾーン オフセットを含む、出発地点からの出発日時。 タイム ゾーン オフセットが指定されていない場合は、原点のオフセットと見なされます。

  • 既定値: 今すぐ
  • その他の値: dateTime

例 :

  • 2023-12-19T16:39:57
  • 2023-12-20T00:39:57+00:00

パラメーターを departAt と arriveAt組み合わせて使用することはできません。
distanceBudgetInMeters
 query

number

double

走行距離を使用して移動できる最大範囲を決定する距離予算 (メートル単位)。 従量課金モデルは、routeType が eco の場合にのみ範囲に影響します。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。
downhillEfficiency
 query

number

double

車両が標高を失ったとき (つまり、ChemicalEnergySaved/PotentialEnergyLost) に対して、潜在的なエネルギーを節約 (消費されていない) 燃料に変換する効率を指定します。ChemicalEnergySaved は、 fuelEnergyDensityInMJoulesPerLiter を使用して、保存された (消費されていない) 燃料をエネルギーに変換することによって取得されます。

uphillEfficiency とペアにする必要があります。

使用できる値の範囲は 0.0 ~ 1/uphillEfficiency です。

良識値 : 燃焼モデル の場合 : 0.51, 電気モデル : 0.73
energyBudgetInkWh
 query

number

double

指定された電力消費モデルを使用して走行できる最大範囲を決定するキロワット時間 (kWh) の電力エネルギー予算。
energyBudgetInkWh を使用する場合は、詳細な電力消費モデルを指定する必要があります。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。
fuelBudgetInLiters
 query

number

double

指定された燃焼消費モデルを使用して走行可能な最大範囲を決定するリットル単位の燃料予算。
fuelBudgetInLiters を使用する場合は、詳細な燃焼消費モデルを指定する必要があります。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。
fuelEnergyDensityInMJoulesPerLiter
 query

number

double

メガジュール (MJ) 内の 1 リットルの燃料に格納される化学エネルギーの量を指定します。 これは、保存または消費されたエネルギーと燃料の間の変換のために*効率 パラメータと組み合わせて使用されます。 たとえば、エネルギー密度はガソリンの場合は 34.2 MJ/l、ディーゼル燃料の場合は 35.8 MJ/l です。

*Efficiency パラメーターが設定されている場合は、このパラメーターが必要です。

賢明な値: 34.2
hilliness
 query

InclineLevel

スリル満点のルートのための丘陵性の程度。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。
maxChargeInkWh
 query

number

double

車両のバッテリーに格納できる最大電力供給量をキロワット時 (kWh) 単位で指定します。

このパラメーターは currentChargeInkWh パラメーターと共に存在します。

最小値は currentChargeInkWh 以上である必要があります。

賢明な値: 85
routeType
 query

RouteType

要求されたルートの種類。
timeBudgetInSec
 query

number

double

運転時間を使用して移動できる最大範囲を決定する時間予算 (秒)。 従量課金モデルは、routeType が eco の場合にのみ範囲に影響します。
1 つの予算 (fuelBudgetInLiters、energyBudgetInkWh、timeBudgetInSec、または distanceBudgetInMeters) を使用する必要があります。
traffic
 query

boolean

指定できる値

  • true - ルーティング中に使用可能なすべてのトラフィック情報を考慮する
  • false - ルーティング中に現在のトラフィック データを無視します。 現在のトラフィック データはルーティング中は無視されますが、有効な道路速度に対する履歴トラフィックの影響は引き続き組み込まれることに注意してください。
travelMode
 query

TravelMode

要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode は、ルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。
uphillEfficiency
 query

number

double

車両が昇格したときに、燃料に格納されている化学エネルギーを潜在的なエネルギーに変換する効率を指定します (つまり、PotentialEnergyGained/ChemicalEnergyConsumed)。ChemicalEnergyConsumed は、 fuelEnergyDensityInMJoulesPerLiter を使用して、消費された燃料を化学エネルギーに変換することによって得られます。

ダウンヒル効率性と組み合わせて使用する必要があります。

使用できる値の範囲は 0.0 ~ 1/分の 1 です。非効率性です。

良識値 : 燃焼モデル の場合 : 0.27, 電気モデル : 0.74
vehicleAxleWeight
 query

integer

車両の車軸あたりの重量 (kg)。 値が 0 の場合、車軸あたりの重量制限は考慮されません。
vehicleCommercial
 query

boolean

車両が商用目的で使用されているかどうか。 一部の道路では商用車の運転が許可されない場合があります。
vehicleEngineType
 query

VehicleEngineType

車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。
vehicleHeight
 query

number

double

車両の高さ (メートル単位)。 値が 0 の場合、高さの制限は考慮されません。
vehicleLength
 query

number

double

車両の長さ (メートル単位)。 値 0 は、長さの制限が考慮されないことを意味します。
vehicleLoadType
 query

VehicleLoadType

危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国ルーティング用であり、otherHazmat は他のすべての国/地域に使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。
vehicleMaxSpeed
 query

integer

キロ/時の車両の最高速度。 車両プロファイルの最大速度は、高速道路で車両が許可されているかどうかをチェックするために使用されます。

  • 値 0 は、ルート計画中に車両に適切な値が決定され、適用されることを意味します。

  • 0 以外の値は、ルート計画中にオーバーライドされる可能性があります。 たとえば、現在のトラフィック フローは 60 km/時です。 車両の最高速度が 50 km/時に設定されている場合、現在の状況であるため、ルーティング エンジンは 60 km/時を考慮します。 車両の最高速度が 80 km/時として提供されているが、現在の交通フローが 60 km/時である場合、ルーティング エンジンは再び 60 km/時を使用します。
vehicleWeight
 query

integer

車両の重量 (キロ単位)。

  • *効率パラメーターのいずれかが設定されている場合は必須です。

  • 従量課金モデルのコンテキストで使用する場合は、厳密に正である必要があります。 重みの制限が考慮されます。

  • 詳細な 従量課金モデル が指定されておらず、 vehicleWeight の値が 0 以外の場合は、重量制限が考慮されます。

  • それ以外の場合は、このパラメーターは無視されます。

良識値 : 燃焼モデル の場合 : 1600, 電気モデル : 1900
vehicleWidth
 query

number

double

車両の幅 (メートル単位)。 値が 0 の場合、幅の制限は考慮されません。
windingness
 query

WindingnessLevel

スリル満点のルートのターンのレベル。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。

要求ヘッダー

名前 必須 型 説明
x-ms-client-id

string

Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、ガイダンスについては、次の記事を参照してください。

応答

名前 型 説明
200 OK

RouteRangeResult

OK
Other Status Codes

ErrorResponse

予期しないエラーが発生しました。

セキュリティ

AADToken

これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API をAzure Mapsするための 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、ユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。

シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。

メモ

  • このセキュリティ定義では、 ヘッダーを使用して、x-ms-client-idアプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。

は Authorization URL 、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、固有の承認 URL とMicrosoft Entra ID構成があります。 * Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。 * Azure Maps Web SDK を使用すると、複数のユース ケースに対してアプリケーションを構成ベースで設定できます。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前 説明
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

これは、Azure portalでAzure Maps アカウントをCreateするとき、または PowerShell、CLI、Azure SDK、または REST API を使用してプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションですべての REST API にアクセスできます。 つまり、このキーは、発行先のアカウントのマスター キーとして使用できます。

公開されているアプリケーションの場合は、機密クライアント アプリケーション のアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。

Type: apiKey
In: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンに対するきめ細かい制御が許可されます。 言い換えると、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できます。

公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定のリストを構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。

Type: apiKey
In: header

例

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Sample Request

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Sample Response

Status code:
200 
{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

定義

名前 説明
EffectiveSetting

このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。
ErrorAdditionalInfo

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答
InclineLevel

スリル満点のルートのための丘陵性の程度。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。
LatLongPair

緯度と経度として表される場所。
ResponseFormat

応答の目的の形式。 値には json または xml を指定できます。
RouteAvoidType

ルートの決定時にルート計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。 ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。
RouteRange

到達可能な範囲
RouteRangeResult

このオブジェクトは、ルート到達可能範囲の呼び出しが成功した場合に返されます
RouteReport

現在の呼び出しで使用されている有効な設定を報告します。
RouteType

要求されたルートの種類。
TravelMode

要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode は、ルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。
VehicleEngineType

車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。
VehicleLoadType

危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国ルーティング用であり、otherHazmat は他のすべての国/地域に使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。
WindingnessLevel

スリル満点のルートのターンのレベル。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。

EffectiveSetting

このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。

名前 型 説明
key

string

使用されるパラメーターの名前。
value

string

使用されるパラメーターの値。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細です。
message

string

エラー メッセージ。
target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 型 説明
error

ErrorDetail

error オブジェクト。

InclineLevel

スリル満点のルートのための丘陵性の程度。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。

名前 型 説明
high

string

high
low

string

low
normal

string

普通

LatLongPair

緯度と経度として表される場所。

名前 型 説明
latitude

number

Latitude プロパティ
longitude

number

Longitude プロパティ

ResponseFormat

応答の目的の形式。 値には json または xml を指定できます。

名前 型 説明
json

string

JavaScript オブジェクト表記データ交換形式
xml

string

拡張可能なマークアップ言語

RouteAvoidType

ルートの決定時にルート計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。 ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。

名前 型 説明
alreadyUsedRoads

string

同じ道路を複数回使用しないようにします。 =スリル満点と routeType組み合わせて最も便利です。
borderCrossings

string

ルート計算で境界の交差を回避します。
carpools

string

カープール(HOV/高占有車)レーンの使用を必要とするルートを回避します。
ferries

string

フェリーを避ける
motorways

string

高速道路を避ける
tollRoads

string

有料道路を回避します。
unpavedRoads

string

未舗装道路を回避する

RouteRange

到達可能な範囲

名前 型 説明
boundary

LatLongPair[]

ポイントのリストとして表される到達可能範囲の多角形境界。
center

LatLongPair

到達可能範囲の中心点

RouteRangeResult

このオブジェクトは、ルート到達可能範囲の呼び出しが成功した場合に返されます

名前 型 説明
formatVersion

string

Format Version プロパティ
reachableRange

RouteRange

到達可能な範囲
report

RouteReport

現在の呼び出しで使用されている有効な設定を報告します。

RouteReport

現在の呼び出しで使用されている有効な設定を報告します。

名前 型 説明
effectiveSettings

EffectiveSetting[]

このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。

RouteType

要求されたルートの種類。

名前 型 説明
eco

string

経済とスピードでバランスの取れたルート。
fastest

string

最速のルート。
shortest

string

距離別の最短ルート。
thrilling

string

興味深いまたは困難な道路が含まれており、できるだけ少ない高速道路を使用します。 含まれるターンのレベルと、ヒルネスの度合いを選択できます。 これを設定する方法については、丘陵性と巻き上げ性のパラメーターを参照してください。 =スリル満点で計画された routeTypeルートには900kmの制限があります

TravelMode

要求されたルートの移動モード。 定義されていない場合、既定値は 'car' です。 要求された travelMode は、ルート全体で使用できない場合があることに注意してください。 要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。 移動モードバス、オートバイ、タクシー、バンはベータ機能であることに注意してください。 すべての領域で完全な制限データを使用できるわけではありません。

名前 型 説明
bus

string

返されるルートは、バス専用レーンの使用を含め、バス用に最適化されています。 BETA 機能。
car

string

返されるルートは、車用に最適化されています。
motorcycle

string

返されるルートはオートバイ用に最適化されています。 BETA 機能。
taxi

string

返されるルートはタクシー用に最適化されています。 BETA 機能。
truck

string

返されるルートは、トラックなどの商用車用に最適化されています。
van

string

返されるルートはバン用に最適化されています。 BETA 機能。

VehicleEngineType

車両のエンジンタイプ。 詳細な従量課金モデルを指定する場合は、 vehicleEngineType の値と一致している必要があります。

名前 型 説明
combustion

string

内燃機関。
electric

string

電気エンジン。

VehicleLoadType

危険物として分類され、一部の道路から制限される可能性のある貨物の種類。 使用可能な vehicleLoadType 値は、US Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国ルーティング用であり、otherHazmat は他のすべての国/地域に使用する必要があります。 vehicleLoadType は複数回指定できます。 このパラメーターは現在、travelMode=truck でのみ考慮されています。

名前 型 説明
USHazmatClass1

string

火薬類
USHazmatClass2

string

圧縮ガス
USHazmatClass3

string

引火性液体
USHazmatClass4

string

引火性固体
USHazmatClass5

string

酸化 剤
USHazmatClass6

string

毒
USHazmatClass7

string

放射性物質
USHazmatClass8

string

腐食性
USHazmatClass9

string

その他
otherHazmatExplosive

string

火薬類
otherHazmatGeneral

string

その他
otherHazmatHarmfulToWater

string

水に害を

WindingnessLevel

スリル満点のルートのターンのレベル。 このパラメーターは、=thrilling と routeType組み合わせてのみ使用できます。

名前 型 説明
high

string

high
low

string

low
normal

string

普通