Route - Post Snap To Roads

도로 맞춤 API는 경도 및 위도 좌표로 표현되는 GPS 지점 데이터를 허용하고 지도의 기존 도로와 일치하는 지점을 생성합니다. "도로에 맞추기"라고 하는 이 프로세스는 도로 네트워크 뒤의 경로를 밀접하게 추적하는 일련의 개체를 생성합니다. 결과 데이터에는 이동 세그먼트와 관련된 도로 이름 및 해당 속도 제한이 포함됩니다.

또한 도로로 맞춤 API는 GPS 지점을 구체화하여 도로의 기하 도형을 준수하는 더 부드러운 경로를 만드는 보간 기능을 제공합니다. 이 기능은 특히 매핑 애플리케이션에서 자산 추적 및 데이터 시각화 향상에 유용합니다.

국가/지역의 라우팅 가용성에 대한 자세한 내용은 Azure Maps 라우팅 적용 범위참조하세요.

POST https://atlas.microsoft.com/route/snapToRoads?api-version=2025-01-01

URI 매개 변수

요청 헤더

Media Types: "application/geo+json"

요청 본문

Media Types: "application/geo+json"

응답

보안

AADToken

다음은 Microsoft Entra OAuth 2.0 흐름에 . Azure 역할 기반 액세스 컨트롤과 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

시나리오를 구현하려면인증 개념을 확인하는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

subscription-key

Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스를 만들 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정의 마스터 키로 처리될 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

SAS Token

공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.

이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.

형식: apiKey
In(다음 안에): header

예제

Successfully retrieve snap to roads points with additional parameters in the body

POST https://atlas.microsoft.com/route/snapToRoads?api-version=2025-01-01

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.336729,
          47.590868
        ],
        "type": "Point"
      },
      "properties": {}
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.336042,
          47.601604
        ],
        "type": "Point"
      },
      "properties": {}
    }
  ],
  "includeSpeedLimit": true,
  "travelMode": "driving"
}

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.336769,
          47.590885
        ],
        "type": "Point"
      },
      "properties": {
        "inputIndex": 0,
        "isInterpolated": false,
        "name": "State Rte-99 N",
        "speedLimitInKilometersPerHour": 80
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.336008,
          47.601609
        ],
        "type": "Point"
      },
      "properties": {
        "inputIndex": 1,
        "isInterpolated": false,
        "name": "State Rte-99 N",
        "speedLimitInKilometersPerHour": 80
      }
    }
  ]
}

정의

FeaturesItemTypeEnum

GeoJSON 형식을 지정합니다. 유일하게 지원되는 개체 유형은 Feature입니다. 자세한 내용은 RFC 7946을 참조하세요.

FeatureTypeEnum

GeoJSON 형식을 지정합니다. 지원되는 유일한 개체 형식은 FeatureCollection. 자세한 내용은 RFC 7946을 참조하세요.

GeoJsonPoint

유효한 GeoJSON Point 기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.

InputSnapToRoadsFeaturesItem

도로 지점에 대한 입력 스냅을 지정합니다. 기능 개체 및 추가 속성을 GeoJSON. 자세한 내용은 RFC 7946 을 참조하십시오.

MapsErrorDetail

오류 세부 정보입니다.

MapsErrorResponse

실패한 작업에 대한 오류 세부 정보를 반환하는 Azure Maps API에 대한 일반적인 오류 응답입니다.

MapsInnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

PointGeometry

범위 다각형을 계산해야 하는 유효한 GeoJSON Geometry 개체로 전달된 원점입니다. 자세한 내용은 RFC 7946 참조하세요.

Note: API는 요청된 원본 지점을 가장 가까운 도로 네트워크에 스냅하고 범위 계산에 사용합니다. 응답의 center 지점으로 반환됩니다.

SnapToRoadFeaturesItem

Geometry 개체와 경로의 추가 속성을 포함하는 GeoJSON 기능 개체입니다.

SnapToRoadsFeatureProperties

도로 속성에 스냅합니다.

SnapToRoadsRequest

이 개체는 요청 본문입니다.

SnapToRoadsResponse

이 개체는 성공적인 호출에서 반환됩니다.

SnapToRoadsTravelModeEnum

점을 맞추기 위한 라우팅 프로필을 지정합니다. 지정되지 않은 경우 기본 모드는 "운전"으로, 주행 경로에 대해 스냅된 지점을 최적화합니다.