Route - Post Snap To Roads

API оснастки для дорог принимает данные точки GPS, представленные как координаты долготы и широты, и создает точки, которые соответствуют существующим дорожным путям на карте. Этот процесс, известный как "привязка к дорогам", создает ряд объектов, которые трассирует путь близко после дорожной сети. Полученные данные включают имена дорог и соответствующие ограничения скорости, относящиеся к пересекаемых сегментах.

Кроме того, API Snap to Road предлагает функцию интерполяции, которая уточнить точки 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 его можно использовать для управления доступом к REST API Azure Maps. Управление доступом на основе ролей Azure используется для назначения доступа к одной или нескольким учетным записям ресурсов Azure Maps или вложенным ресурсам. Доступ к любому пользователю, группе или субъекту-службе можно предоставить через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений для REST API Azure Maps.

Для реализации сценариев рекомендуется просматривать концепции проверки подлинности . В целом, это определение безопасности предоставляет решение для моделирования приложений через объекты, способные управлять доступом в определенных API и областях.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

subscription-key

Это общий ключ, подготовленный при создании ресурса Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого ключа любой приложению разрешен доступ ко всем REST API. Другими словами, они в настоящее время могут рассматриваться как главные ключи учетной записи, для которой они выданы.

Для общедоступных приложений мы рекомендуем использовать доступ к REST API Azure Maps на сервере, где этот ключ можно безопасно хранить.

Тип: apiKey
В: header

SAS Token

Это маркер подписанного URL-адреса создается из операции SAS списка на ресурсе Azure Maps через плоскость управления Azure с помощью портала Azure, PowerShell, CLI, пакетов SDK Azure или REST API.

С помощью этого маркера любой приложению разрешен доступ с помощью управления доступом на основе ролей Azure и точного управления сроком действия, скоростью и регионами, используемыми для конкретного маркера. Другими словами, маркер SAS можно использовать для разрешения приложений управлять доступом более защищенным способом, чем общий ключ.

Для общедоступных приложений мы рекомендуем настроить определенный список разрешенных источников в ресурсе учетной записи карты карты, чтобы ограничить злоупотребление отрисовкой и регулярно обновлять маркер SAS.

Тип: apiKey
В: 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,
        "name": "WA-99 N",
        "speedLimitInKilometersPerHour": 80
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [
          -122.336008,
          47.601609
        ],
        "type": "Point"
      },
      "properties": {
        "inputIndex": 1,
        "name": "WA-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

Распространенный ответ об ошибке для API Azure Maps для возврата сведений об ошибке для неудачных операций.

MapsInnerError

Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.

PointGeometry

Точка источника, передаваемая в качестве допустимого объекта GeoJSON Geometry, из которого должен вычисляться многоугольник диапазона. Дополнительные сведения см. в RFC 7946.

Note: API привязывает запрошенную точку источника к ближайшей дорожной сети и будет использовать ее для вычисления диапазона. Он будет возвращен в качестве center точки в ответе.

SnapToRoadFeaturesItem

Объект функции GeoJSON, содержащий объект Geometry и дополнительные свойства маршрута.

SnapToRoadsFeatureProperties

Привязка к свойствам "Дороги".

SnapToRoadsRequest

Этот объект является текстом запроса.

SnapToRoadsResponse

Этот объект возвращается из успешного вызова.

SnapToRoadsTravelModeEnum

Задает профиль маршрутизации для привязки точек. Если не указано, по умолчанию используется режим вождения, который оптимизирует оснастки для маршрутов вождения.