RouteURL class
RouteURL은 Azure Maps 경로 작업에 대한 URL을 나타냅니다.
- Extends
생성자
| RouteURL(Pipeline, string) | RouteURL의 instance 만듭니다. |
상속된 속성
| maps |
기본 URL 문자열 값입니다. |
메서드
| calculate |
원점과 대상 간의 경로를 반환하여 지정된 경우 웨이포인트를 통과합니다. 이 경로는 현재 교통량과 요청된 요일 및 시간에 대한 일반적인 도로 속도와 같은 요인을 고려합니다. 반환되는 정보에는 거리, 예상 이동 시간 및 경로 기하 도형의 표현이 포함됩니다. 선택한 옵션에 따라 최적화된 웨이포인트 순서 또는 턴 바이턴 지침과 같은 추가 라우팅 정보도 사용할 수 있습니다. 라우팅 서비스는 차량별 소비 모델에 대한 자세한 설명을 위한 매개 변수 집합을 제공합니다. 관련된 개념 및 매개 변수에 대한 자세한 설명은 소비 모델을 검사. 가 지정된 경우 그렇지 않으면 경로 방향 가져오기 API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/getroutedirections |
| calculate |
참고: 이 API는 현재 미리 보기 상태이며 호환성이 손상되는 변경이 발생할 수 있습니다. 원본 및 대상 위치로 정의된 경로 집합에 대한 경로 요약 행렬을 계산합니다. 지정된 모든 원본에 대해 이 서비스는 해당 원본에서 지정된 모든 대상으로 라우팅하는 비용을 계산합니다. 원본 집합 및 대상 집합은 테이블의 열 및 행 머리글로 간주할 수 있으며 테이블의 각 셀에는 원본에서 해당 셀의 대상으로 라우팅하는 비용이 포함됩니다. 각 경로에 대해 이동 시간과 거리가 계산됩니다. 계산된 비용을 사용하여 라우팅 방향 API를 사용하여 계산할 경로를 결정할 수 있습니다. 요청의 waitForResults 매개 변수가 false(기본값)로 설정된 경우 이 API는 응답 헤더의 위치 필드에 있는 리디렉션 URL을 따라 202 응답 코드를 반환합니다. 이 URL은 응답 데이터 또는 오류 정보를 사용할 수 있을 때까지 주기적으로 확인해야 합니다. 이 API에 대한 행렬의 최대 크기는 700입니다(원본 수에 대상 수를 곱한 수). 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 50x10, 10x10, 28x25입니다. 10x70(정사각형일 필요는 없음) 경로 행렬 계산은 장기 실행 작업으로 간주됩니다. 장기 실행 작업은 초기 요청이 수락된 후(HTTP 202) 최종 결과가 사용할 수 있을 때까지 폴링됨을 의미합니다. 지정된 경우 각 폴링 요청은 중단자의 시간 제한을 다시 시작합니다. Post Route Matrix API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview |
| calculate |
지정된 연료, 에너지 또는 시간 예산에 따라 원점에서 도달할 수 있는 위치 집합을 계산합니다. 다각형 경계(또는 Isochrone)는 원점의 결과인 정확한 다각형 중심뿐만 아니라 시계 반대 방향으로 반환됩니다. 반환된 다각형은 제공된 Isochrone 내에서 POI를 검색하기 위해 Search 내부 기하 도형과 같은 추가 처리에 사용할 수 있습니다. 경로 범위 가져오기 API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/getrouterange |
상속된 메서드
| new |
자격 증명이 제공된 새 Pipeline 개체를 만드는 데 사용되는 정적 메서드입니다. |
생성자 세부 정보
RouteURL(Pipeline, string)
RouteURL의 instance 만듭니다.
new RouteURL(pipeline: Pipeline, mapsUrl?: string)매개 변수
- pipeline
- Pipeline
MapsURL.newPipeline()을 호출하여 기본 파이프라인을 만들거나 사용자 지정된 파이프라인을 제공합니다.
- mapsUrl
-
string
Azure Maps 서비스를 가리키는 URL 문자열은 기본값입니다"https://atlas.microsoft.com".
프로토콜이 지정되지 않은 경우(예: "atlas.microsoft.com") 가 https 가정됩니다.
상속된 속성 세부 정보
mapsUrl
메서드 세부 정보
calculateRouteDirections(Aborter, GeoJSON.Position[], CalculateRouteDirectionsOptions)
원점과 대상 간의 경로를 반환하여 지정된 경우 웨이포인트를 통과합니다. 이 경로는 현재 교통량과 요청된 요일 및 시간에 대한 일반적인 도로 속도와 같은 요인을 고려합니다. 반환되는 정보에는 거리, 예상 이동 시간 및 경로 기하 도형의 표현이 포함됩니다. 선택한 옵션에 따라 최적화된 웨이포인트 순서 또는 턴 바이턴 지침과 같은 추가 라우팅 정보도 사용할 수 있습니다.
라우팅 서비스는 차량별 소비 모델에 대한 자세한 설명을 위한 매개 변수 집합을 제공합니다. 관련된 개념 및 매개 변수에 대한 자세한 설명은 소비 모델을 검사.
가 지정된 경우 options.postBody Post Route Directions API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/postroutedirections
그렇지 않으면 경로 방향 가져오기 API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/getroutedirections
function calculateRouteDirections(aborter: Aborter, coordinates: GeoJSON.Position[], options?: CalculateRouteDirectionsOptions): Promise<CalculateRouteDirectionsResponse>매개 변수
- aborter
- Aborter
요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout(), Aborter의 goto 문서를 사용하여 새 중단자 instance 만듭니다.
- coordinates
-
GeoJSON.Position[]
경로가 계산되는 좌표 배열입니다.
각 좌표는 의 배열입니다 [longitude, latitude]. 최소 2개의 좌표가 필요합니다.
첫 번째는 원본이고 마지막은 경로의 대상입니다.
사이에 있는 선택적 좌표는 경로에서 WayPoint로 작동합니다. 최대 150개의 WayPoint를 전달할 수 있습니다.
- options
- CalculateRouteDirectionsOptions
반환
Promise<CalculateRouteDirectionsResponse>
calculateRouteMatrix(Aborter, CalculateRouteMatrixRequestBody, CalculateRouteMatrixOptions)
참고: 이 API는 현재 미리 보기 상태이며 호환성이 손상되는 변경이 발생할 수 있습니다. 원본 및 대상 위치로 정의된 경로 집합에 대한 경로 요약 행렬을 계산합니다. 지정된 모든 원본에 대해 이 서비스는 해당 원본에서 지정된 모든 대상으로 라우팅하는 비용을 계산합니다. 원본 집합 및 대상 집합은 테이블의 열 및 행 머리글로 간주할 수 있으며 테이블의 각 셀에는 원본에서 해당 셀의 대상으로 라우팅하는 비용이 포함됩니다. 각 경로에 대해 이동 시간과 거리가 계산됩니다. 계산된 비용을 사용하여 라우팅 방향 API를 사용하여 계산할 경로를 결정할 수 있습니다. 요청의 waitForResults 매개 변수가 false(기본값)로 설정된 경우 이 API는 응답 헤더의 위치 필드에 있는 리디렉션 URL을 따라 202 응답 코드를 반환합니다. 이 URL은 응답 데이터 또는 오류 정보를 사용할 수 있을 때까지 주기적으로 확인해야 합니다. 이 API에 대한 행렬의 최대 크기는 700입니다(원본 수에 대상 수를 곱한 수). 이러한 제약 조건을 염두에 두고 가능한 행렬 차원의 예는 50x10, 10x10, 28x25입니다. 10x70(정사각형일 필요는 없음)
경로 행렬 계산은 장기 실행 작업으로 간주됩니다. 장기 실행 작업은 초기 요청이 수락된 후(HTTP 202) 최종 결과가 사용할 수 있을 때까지 폴링됨을 의미합니다. 지정된 경우 각 폴링 요청은 중단자의 시간 제한을 다시 시작합니다.
Post Route Matrix API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/postroutematrixpreview
function calculateRouteMatrix(aborter: Aborter, body: CalculateRouteMatrixRequestBody, options?: CalculateRouteMatrixOptions): Promise<CalculateRouteMatrixResponse>매개 변수
- aborter
- Aborter
요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.
원본 및 대상 좌표의 행렬은 입력 매개 변수를 기반으로 행렬의 각 셀에 대한 경로 거리, 이동 시간 및 기타 요약을 계산합니다. 지원되는 최소 셀 수와 최대 셀 수는 각각 1과 700입니다. 예를 들어 35개의 원본과 20개의 대상 또는 25개의 원본 및 25개의 대상이 될 수 있습니다.
- options
- CalculateRouteMatrixOptions
반환
Promise<CalculateRouteMatrixResponse>
calculateRouteRange(Aborter, GeoJSON.Position, CalculateRouteRangeOptions)
지정된 연료, 에너지 또는 시간 예산에 따라 원점에서 도달할 수 있는 위치 집합을 계산합니다. 다각형 경계(또는 Isochrone)는 원점의 결과인 정확한 다각형 중심뿐만 아니라 시계 반대 방향으로 반환됩니다. 반환된 다각형은 제공된 Isochrone 내에서 POI를 검색하기 위해 Search 내부 기하 도형과 같은 추가 처리에 사용할 수 있습니다.
경로 범위 가져오기 API를 사용합니다. https://docs.microsoft.com/rest/api/maps/route/getrouterange
function calculateRouteRange(aborter: Aborter, center: GeoJSON.Position, options?: CalculateRouteRangeOptions): Promise<CalculateRouteRangeResponse>매개 변수
- aborter
- Aborter
요청 취소에 대한 자세한 예제를 보려면 Aborter.none 또는 Aborter.timeout()을 사용하여 새 Aborter instance 만듭니다.
- center
- GeoJSON.Position
범위 계산을 시작해야 하는 좌표입니다.
- options
- CalculateRouteRangeOptions
반환
Promise<CalculateRouteRangeResponse>
상속된 메서드 세부 정보
newPipeline(Credential, INewPipelineOptions)
자격 증명이 제공된 새 Pipeline 개체를 만드는 데 사용되는 정적 메서드입니다.
static function newPipeline(credential: Credential, pipelineOptions?: INewPipelineOptions): Pipeline매개 변수
- credential
- Credential
SubscriptionKeyCredential, TokenCredential 및 MapControlCredential과 같은 경우
- pipelineOptions
- INewPipelineOptions
반환
새 Pipeline 개체입니다.
MapsURL.newPipeline에서 상속됨