Route - Post Route Matrix
비동기 요청을 사용하여 출발지 및 대상 목록에서 가능한 모든 쌍의 이동 시간과 거리를 보여 주는 경로 매트릭스를 가져오는 데 사용합니다.
Post Route Matrix
API는 비동기(비동기) 요청을 사용하여 원본 및 대상 위치에 정의된 경로 집합에 대한 경로 요약 행렬을 계산할 수 있는 HTTP POST
요청입니다. 동기(동기화) 요청을 만들려면 경로 매트릭스 동기화 후를 참조하세요. 지정된 모든 원본에 대해 서비스는 해당 원본에서 지정된 모든 대상으로 라우팅하는 비용을 계산합니다. 원본 집합과 대상 집합은 테이블의 열 및 행 머리글로 간주할 수 있으며 테이블의 각 셀에는 원본에서 해당 셀의 대상으로 라우팅하는 비용이 포함됩니다. 예를 들어 음식 배달 회사에는 20명의 운전자가 있으며 식당에서 배달을 받을 가장 가까운 드라이버를 찾아야 한다고 가정해 보겠습니다. 이 사용 사례를 해결하기 위해 행렬 경로 API를 호출할 수 있습니다.
각 경로에 대해 이동 시간과 거리가 반환됩니다. 계산 비용을 사용하여 경로 방향 API를 사용하여 계산할 자세한 경로를 결정할 수 있습니다.
비동기 요청에 대한 행렬의 최대 크기는 700 이며 동기화 요청의 경우 100 입니다(원본 수에 대상 수를 곱한 값).
동기 경로 매트릭스 요청 제출
시나리오에 동기 요청이 필요하고 행렬의 최대 크기가 100보다 작거나 같은 경우 동기 요청을 수행할 수 있습니다. 이 API에 대한 행렬의 최대 크기는 100 입니다(원본 수에 대상 수를 곱한 값). 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 10x10, 6x8, 9x8입니다(정사각형일 필요는 없음).
POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}
비동기 경로 매트릭스 요청 제출
비동기 API는 비교적 복잡한 라우팅 요청의 큰 볼륨을 처리하는 데 적합합니다. 비동기 요청을 사용하여 요청을 수행하면 기본적으로 서비스는 응답 헤더의 위치 필드에 있는 리디렉션 URL을 따라 202 응답 코드를 반환합니다. 이 URL은 응답 데이터 또는 오류 정보를 사용할 수 있을 때까지 주기적으로 확인해야 합니다. 요청의 매개 변수가 true로 설정된 경우 waitForResults
요청이 120초 미만으로 완료되면 사용자에게 200 응답이 표시됩니다.
이 API에 대한 행렬의 최대 크기는 700 입니다(원본 수에 대상 수를 곱한 수). 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 50x10, 10x10, 28x25입니다. 10x70(정사각형일 필요는 없음).
비동기 응답은 14 일 동안 저장됩니다. 리디렉션 URL은 만료 기간 이후에 사용되는 경우 404 응답을 반환합니다.
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}
일반적인 비동기 작업 시퀀스는 다음과 같습니다.
클라이언트가 Azure Maps에 경로 매트릭스 POST 요청을 보냅니다.
서버는 다음 중 하나로 응답합니다.
HTTP
202 Accepted
- 경로 매트릭스 요청이 수락되었습니다.HTTP
Error
- 경로 매트릭스 요청을 처리하는 동안 오류가 발생했습니다. 400 잘못된 요청 또는 기타 오류 상태 코드일 수 있습니다.행렬 경로 요청이 성공적으로 수락되면 응답의 위치 헤더에 요청 결과를 다운로드할 URL이 포함됩니다. 이 상태 URI는 다음과 같습니다.
GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
- 클라이언트는 3단계에서 얻은 다운로드 URL에 대한 GET 요청을 실행하여 결과를 다운로드합니다.
동기화 결과 다운로드
경로 매트릭스 동기화 API에 대한 POST 요청을 수행하면 서비스는 성공적인 요청 및 응답 배열에 대해 200개 응답 코드를 반환합니다. 응답 본문에는 데이터가 포함되며 나중에 결과를 검색할 가능성이 없습니다.
비동기 결과 다운로드
요청이 응답을 발급하면 202 Accepted
비동기 파이프라인을 사용하여 요청이 처리됩니다. 응답의 위치 헤더에서 비동기 요청의 진행률을 확인하는 URL이 제공됩니다. 이 상태 URI는 다음과 같습니다.
GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
위치 헤더에서 제공하는 URL은 요청이 실행될 때 GET
다음 응답을 반환합니다.
HTTP
202 Accepted
- 행렬 요청이 수락되었지만 여전히 처리 중입니다. 잠시 후 다시 시도하세요.
HTTP
200 OK
- 행렬 요청이 성공적으로 처리되었습니다. 응답 본문에는 모든 결과가 포함됩니다.
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}§ionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다.
|
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호. |
arrive
|
query |
string date-time |
선택적 표준 시간대 오프셋이 있는 RFC 3339 섹션 5.6에 정의된 값으로 예:
매개 변수는 |
|
avoid
|
query |
경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다. 예를 들어 '&avoid=motorways&avoid=tollRoads&avoid=ferries'입니다. 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다. |
||
compute
|
query |
다양한 유형의 교통 정보(없음, 기록, 라이브)와 기본 최적 추정 이동 시간을 사용하여 추가 이동 시간을 반환할지 여부를 지정합니다. |
||
depart
|
query |
string date-time |
선택적 표준 시간대 오프셋이 있는 RFC 3339 섹션 5.6에 정의된 값으로
예:
매개 변수는 |
|
hilliness
|
query |
스릴 넘치는 루트에 대한 언덕의 정도. 이 매개 변수는 =thrilling과 함께 |
||
route
|
query |
요청된 경로의 유형입니다. |
||
section
|
query |
경로 응답에서 보고되는 섹션 형식을 지정합니다. |
||
traffic
|
query |
boolean |
가능한 값은 다음과 같습니다.
|
|
travel
|
query |
요청된 경로에 대한 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 특정 섹션에 대해 요청된 travelMode를 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 이동 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다. |
||
vehicle
|
query |
integer |
차량의 차축당 무게(kg)입니다. 값이 0이면 액슬당 가중치 제한이 고려되지 않습니다. |
|
vehicle
|
query |
number double |
차량의 높이(미터)입니다. 값이 0이면 높이 제한이 고려되지 않습니다. |
|
vehicle
|
query |
number double |
차량의 길이(미터)입니다. 값이 0이면 길이 제한이 고려되지 않습니다. |
|
vehicle
|
query |
위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅을 위한 반면 otherHazmat는 다른 모든 국가/지역에 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다. |
||
vehicle
|
query |
integer |
차량의 최대 속도(km/시간)입니다. 차량 프로필의 최대 속도는 고속도로에서 차량이 허용되는지 여부를 확인하는 데 사용됩니다.
|
|
vehicle
|
query |
integer |
차량의 무게(킬로그램)입니다. |
|
vehicle
|
query |
number double |
차량 너비(미터)입니다. 값이 0이면 너비 제한이 고려되지 않습니다. |
|
wait
|
query |
boolean |
요청을 동기적으로 실행할지 여부를 나타내는 부울입니다. true로 설정하면 요청이 120초 미만으로 완료되면 사용자에게 200 응답이 표시됩니다. 그렇지 않으면 사용자는 즉시 202 응답을 받게 됩니다. 202 응답에 대한 자세한 내용은 API 설명을 참조하세요. 비동기 요청에 대해서만 지원됩니다. |
|
windingness
|
query |
스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 =thrilling과 함께 |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하려면 지침은 다음 문서를 참조하세요. |
요청 본문
Name | 형식 | Description |
---|---|---|
destinations |
유효한 |
|
origins |
유효한 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
행렬 요청이 성공적으로 처리되었습니다. 응답 본문에는 모든 결과가 포함됩니다. |
|
202 Accepted |
비동기 요청에 대해서만 지원됩니다. 요청 수락됨: 처리를 위해 요청이 수락되었습니다. 위치 헤더의 URL을 사용하여 결과를 다시 시도하거나 액세스하세요. 헤더 Location: string |
|
Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.
참고
- 이 보안 정의를 사용하려면 헤더를 사용하여 애플리케이션이
x-ms-client-id
액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.
Authorization URL
은 Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면 에서 구성됩니다.
* Azure Maps 웹 SDK 를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Azure Portal에서 Azure Maps 계정을 만들 거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키는 발급된 계정에서 마스터 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
query
SAS Token
Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스 의 SAS 나열 작업에서 생성된 공유 액세스 서명 토큰입니다.
이 토큰을 사용하면 모든 애플리케이션이 특정 토큰에 사용할 만료, 속도 및 지역에 대한 Azure 역할 기반 액세스 제어 및 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Successfully submit a route matrix request
샘플 요청
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&routeType=shortest
{
"origins": {
"type": "MultiPoint",
"coordinates": [
[
4.85106,
52.36006
],
[
4.85056,
52.36187
]
]
},
"destinations": {
"type": "MultiPoint",
"coordinates": [
[
4.85003,
52.36241
],
[
13.42937,
52.50931
]
]
}
}
샘플 응답
{
"formatVersion": "0.0.1",
"matrix": [
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 495,
"travelTimeInSeconds": 134,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-27T22:57:43+00:00"
}
}
},
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 647651,
"travelTimeInSeconds": 26835,
"trafficDelayInSeconds": 489,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-28T06:22:44+00:00"
}
}
}
],
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 338,
"travelTimeInSeconds": 104,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-27T22:57:13+00:00"
}
}
},
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 647494,
"travelTimeInSeconds": 26763,
"trafficDelayInSeconds": 469,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-28T06:21:32+00:00"
}
}
}
]
],
"summary": {
"successfulRoutes": 4,
"totalRoutes": 4
}
}
operation-Location: New URL to check the status of the long-running operation.
정의
Name | Description |
---|---|
Compute |
다양한 유형의 교통 정보(없음, 기록, 라이브)와 기본 최적 예측 이동 시간을 사용하여 추가 이동 시간을 반환할지 여부를 지정합니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Geo |
유효한 |
Incline |
스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 =thrilling과 |
Json |
원하는 응답 형식입니다.
|
Route |
경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다. 예를 들어 'avoid=motorways &avoid=tollRoads&avoid=ferries'를&. 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다. |
Route |
경로 섹션에 대한 요약 개체입니다. |
Route |
행렬 결과 개체 |
Route |
좌표 행렬이 있는 개체입니다. |
Route |
이 개체는 성공적인 경로 매트릭스 호출에서 반환됩니다. 예를 들어 2개의 원본과 3개의 대상이 제공되면 각각 3개의 요소가 있는 2개의 배열이 있습니다. 각 요소의 콘텐츠는 쿼리에 제공된 옵션에 따라 달라집니다. |
Route |
입력 매트릭스에 있는 현재 셀의 응답 개체입니다. |
Route |
요약 개체 |
Route |
요청된 경로의 유형입니다. |
Section |
경로 응답에 보고되는 섹션 형식을 지정합니다. |
Travel |
요청된 경로의 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 요청된 travelMode를 특정 섹션에 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 여행 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다. |
Vehicle |
위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅에 사용되는 반면 otherHazmat는 다른 모든 국가/지역에 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다. |
Windingness |
스릴 넘치는 경로에 대한 회전의 수준. 이 매개 변수는 =thrilling과 |
ComputeTravelTime
다양한 유형의 교통 정보(없음, 기록, 라이브)와 기본 최적 예측 이동 시간을 사용하여 추가 이동 시간을 반환할지 여부를 지정합니다.
Name | 형식 | Description |
---|---|---|
all |
string |
모든 유형의 트래픽 정보에 대한 이동 시간을 계산하고 경로 응답의 요약에 포함되는 noTrafficTravelTimeInSeconds, historicTrafficTravelTimeInSeconds 및 liveTrafficIncidentsTravelTimeInSeconds 필드의 모든 결과를 지정합니다. |
none |
string |
추가 이동 시간을 계산하지 않습니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
GeoJsonMultiPoint
유효한 GeoJSON MultiPoint
기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
기하 도형의 |
type |
string:
Multi |
|
InclineLevel
스릴 넘치는 경로에 대한 언덕의 정도. 이 매개 변수는 =thrilling과 routeType
함께만 사용할 수 있습니다.
Name | 형식 | Description |
---|---|---|
high |
string |
high |
low |
string |
low |
normal |
string |
노멀 |
JsonFormat
원하는 응답 형식입니다.
json
형식만 지원됩니다.
Name | 형식 | Description |
---|---|---|
json |
string |
RouteAvoidType
경로를 결정할 때 경로 계산에서 피해야 하는 항목을 지정합니다. 한 요청에서 여러 번 지정할 수 있습니다. 예를 들어 'avoid=motorways &avoid=tollRoads&avoid=ferries'를&. 경로 범위 요청에서 이미UsedRoads 값을 사용하면 안 됩니다.
Name | 형식 | Description |
---|---|---|
alreadyUsedRoads |
string |
동일한 도로를 여러 번 사용하지 않도록 합니다. =thrilling과 함께 |
borderCrossings |
string |
경로 계산에서 테두리 교차를 방지합니다. |
carpools |
string |
카풀(HOV/높은 점유율 차량) 차선을 사용해야 하는 경로를 방지합니다. |
ferries |
string |
페리 방지 |
motorways |
string |
고속도로 방지 |
tollRoads |
string |
유료 도로를 방지합니다. |
unpavedRoads |
string |
비포장 도로 방지 |
RouteLegSummary
경로 섹션에 대한 요약 개체입니다.
Name | 형식 | Description |
---|---|---|
arrivalTime |
string |
경로 또는 다리의 예상 도착 시간입니다. 시간은 UTC입니다. |
batteryConsumptionInkWh |
number |
전기 소비 모델을 사용하여 KWh(킬로와트시)의 예상 전기 에너지 소비량. vehicleEngineType이 전기로 설정되고 constantSpeedConsumptionInkWhPerHundredkm가 지정된 경우 포함됩니다. batteryConsumptionInkWh 값은 회복된 전기 에너지를 포함하므로 음수일 수 있습니다(에너지 확보를 나타냅니다). maxChargeInkWh와 currentChargeInkWh를 모두 지정하면 배터리 충전 수준이 maxChargeInkWh를 초과하지 않도록 회수가 제한됩니다. maxChargeInkWh와 currentChargeInkWh를 모두 지정하지 않으면 사용량 계산에서 제한되지 않은 회복이 가정됩니다. |
departureTime |
string |
경로 또는 다리의 예상 출발 시간입니다. 시간은 UTC입니다. |
fuelConsumptionInLiters |
number |
연소 소비 모델을 사용하여 리터의 예상 연료 소비량. vehicleEngineType이 연소 로 설정되고 constantSpeedConsumptionInLitersPerHundredkm가 지정된 경우 포함됩니다. 값은 음수가 아닌 값입니다. |
historicTrafficTravelTimeInSeconds |
integer |
시간 종속 기록 트래픽 데이터를 사용하여 계산된 예상 이동 시간입니다. computeTravelTimeFor = 모두 쿼리에 사용되는 경우에만 포함됩니다. |
lengthInMeters |
integer |
Length In 미터 속성 |
liveTrafficIncidentsTravelTimeInSeconds |
integer |
실시간 속도 데이터를 사용하여 계산된 예상 이동 시간입니다. computeTravelTimeFor = 모두 쿼리에 사용되는 경우에만 포함됩니다. |
noTrafficTravelTimeInSeconds |
integer |
교통 상황(예: 혼잡)으로 인해 경로에 지연이 없는 것처럼 계산된 예상 이동 시간입니다. computeTravelTimeFor = 모두 쿼리에 사용되는 경우에만 포함됩니다. |
trafficDelayInSeconds |
integer |
트래픽 정보에 따른 실시간 인시던트로 인한 예상 지연 시간(초)입니다. 향후 출발 시간으로 계획된 경로의 경우 지연은 항상 0입니다. 다양한 유형의 트래픽 정보를 사용하여 추가 이동 시간을 반환하려면 computeTravelTimeFor=all 매개 변수를 추가해야 합니다. |
travelTimeInSeconds |
integer |
실시간 트래픽으로 인한 지연을 포함하는 예상 이동 시간(초) 속성입니다. traffic=false travelTimeInSeconds에도 트래픽으로 인한 지연이 계속 포함됩니다. DepartAt가 향후에 있는 경우 시간 종속 기록 트래픽 데이터를 사용하여 이동 시간을 계산합니다. |
RouteMatrix
행렬 결과 개체
Name | 형식 | Description |
---|---|---|
response |
입력 매트릭스에 있는 현재 셀의 응답 개체입니다. |
|
statusCode |
integer |
입력 매트릭스의 현재 셀에 대한 StatusCode 속성입니다. |
RouteMatrixQuery
좌표 행렬이 있는 개체입니다.
Name | 형식 | Description |
---|---|---|
destinations |
유효한 |
|
origins |
유효한 |
RouteMatrixResult
이 개체는 성공적인 경로 매트릭스 호출에서 반환됩니다. 예를 들어 2개의 원본과 3개의 대상이 제공되면 각각 3개의 요소가 있는 2개의 배열이 있습니다. 각 요소의 콘텐츠는 쿼리에 제공된 옵션에 따라 달라집니다.
Name | 형식 | Description |
---|---|---|
formatVersion |
string |
Format Version 속성 |
matrix |
경로 요약의 2차원 배열로 결과를 가져옵니다. |
|
summary |
요약 개체 |
RouteMatrixResultResponse
입력 매트릭스에 있는 현재 셀의 응답 개체입니다.
Name | 형식 | Description |
---|---|---|
routeSummary |
경로 섹션에 대한 요약 개체입니다. |
RouteMatrixSummary
요약 개체
Name | 형식 | Description |
---|---|---|
successfulRoutes |
integer |
응답에 성공한 경로 수입니다. |
totalRoutes |
integer |
요청된 총 경로 수입니다. 입력 행렬의 셀 수입니다. |
RouteType
요청된 경로의 유형입니다.
Name | 형식 | Description |
---|---|---|
eco |
string |
경제와 속도에 따라 균형 잡힌 경로입니다. |
fastest |
string |
가장 빠른 경로입니다. |
shortest |
string |
거리별 최단 경로입니다. |
thrilling |
string |
흥미롭거나 도전적인 도로를 포함하며 가능한 한 적은 수의 고속도로를 사용합니다. 포함된 턴의 수준과 언덕의 정도를 선택할 수 있습니다. 이를 설정하는 방법은 구불구불함 및 권면 매개 변수를 참조하세요. =스릴 넘치는 노선으로 계획된 |
SectionType
경로 응답에 보고되는 섹션 형식을 지정합니다.
예를 들어 sectionType = 보행자 전용 구역이 반환됩니다. 여러 형식을 사용할 수 있습니다. 기본 sectionType은 travelMode 입력을 참조합니다. 기본적으로 travelMode는 자동차로 설정됩니다.
Name | 형식 | Description |
---|---|---|
carTrain |
string |
자동차 또는 기차인 경로의 섹션입니다. |
carpool |
string |
카풀(HOV/높은 점유율 차량) 차선을 사용해야 하는 경로의 섹션입니다. |
country |
string |
경로가 있는 국가/지역을 나타내는 섹션입니다. |
ferry |
string |
페리 인 경로의 섹션입니다. |
motorway |
string |
고속도로인 경로의 섹션입니다. |
pedestrian |
string |
보행자에게만 적합한 경로의 섹션입니다. |
tollRoad |
string |
통행료를 지불해야 하는 경로의 섹션입니다. |
tollVignette |
string |
유료 비네팅이 있어야 하는 경로의 섹션입니다. |
traffic |
string |
트래픽 정보를 포함하는 경로의 섹션입니다. |
travelMode |
string |
요청 매개 변수 |
tunnel |
string |
터널인 경로의 섹션입니다. |
urban |
string |
도시 지역 내에 있는 경로의 섹션입니다. |
TravelMode
요청된 경로의 이동 모드입니다. 정의되지 않은 경우 기본값은 'car'입니다. 요청된 travelMode를 전체 경로에 사용할 수 없습니다. 요청된 travelMode를 특정 섹션에 사용할 수 없는 경우 해당 섹션에 대한 응답의 travelMode 요소는 "other"가 됩니다. 여행 모드 버스, 오토바이, 택시 및 밴은 BETA 기능입니다. 일부 영역에서는 전체 제한 데이터를 사용할 수 없습니다.
Name | 형식 | Description |
---|---|---|
bicycle |
string |
반환된 경로는 자전거 차선 사용을 포함하여 자전거에 최적화되어 있습니다. |
bus |
string |
반환된 경로는 버스 전용 차선 사용을 포함하여 버스에 최적화되어 있습니다. BETA 기능. |
car |
string |
반환된 경로는 자동차에 최적화되어 있습니다. |
motorcycle |
string |
반환된 경로는 오토바이에 최적화되어 있습니다. BETA 기능. |
pedestrian |
string |
반환된 경로는 보도 사용을 포함하여 보행자에 최적화되어 있습니다. |
taxi |
string |
반환된 경로는 택시에 최적화되어 있습니다. BETA 기능. |
truck |
string |
반환된 경로는 트럭과 같은 상용차에 최적화되어 있습니다. |
van |
string |
반환된 경로는 밴에 최적화되어 있습니다. BETA 기능. |
VehicleLoadType
위험 물질로 분류되고 일부 도로에서 제한될 수 있는 화물 유형입니다. 사용 가능한 vehicleLoadType 값은 미국 Hazmat 클래스 1~9와 다른 국가/지역에서 사용할 일반 분류입니다. USHazmat로 시작하는 값은 미국 라우팅에 사용되는 반면 otherHazmat는 다른 모든 국가/지역에 사용해야 합니다. vehicleLoadType을 여러 번 지정할 수 있습니다. 이 매개 변수는 현재 travelMode=truck에 대해서만 고려됩니다.
Name | 형식 | Description |
---|---|---|
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
함께만 사용할 수 있습니다.
Name | 형식 | Description |
---|---|---|
high |
string |
high |
low |
string |
low |
normal |
string |
노멀 |