Route - Post Snap To Roads

De Snap to Roads-API accepteert GPS-puntgegevens, weergegeven als lengte- en breedtegraadcoördinaten en genereert punten die zijn afgestemd op bestaande wegen op een kaart. Dit proces, ook wel 'uitlijnen op wegen' genoemd, produceert een reeks objecten die een pad volgen dat het wegnetwerk nadert. De resulterende gegevens omvatten wegnamen en hun respectieve snelheidslimieten, die relevant zijn voor de doorkruiste segmenten.

Bovendien biedt de Snap to Roads-API een interpolatiefunctie, waarmee de GPS-punten worden verfijnd om een soepelere route te creëren die voldoet aan de geometrie van de weg. Deze functionaliteit is met name nuttig voor het bijhouden van activa en het verbeteren van gegevensvisualisatie in toewijzingstoepassingen.

Zie Routeringsdekking van Azure Mapsvoor informatie over de beschikbaarheid van routering in landen/regio's.

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

URI-parameters

Aanvraagkoptekst

Media Types: "application/geo+json"

Aanvraagbody

Media Types: "application/geo+json"

Antwoorden

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0 Flows. Wanneer deze is gekoppeld aan op rollen gebaseerd toegangsbeheer van Azure kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang aan te wijzen tot een of meer Azure Maps-resourceaccounts of subresources. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Voor het implementeren van scenario's raden we u aan om verificatieconceptente bekijken. Kortom, deze beveiligingsdefinitie biedt een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen uitvoeren voor specifieke API's en bereiken.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

subscription-key

Dit is een gedeelde sleutel die wordt ingericht bij het maken van een Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met deze sleutel is elke toepassing gemachtigd voor toegang tot alle REST API's. Met andere woorden, deze kunnen momenteel worden behandeld als hoofdsleutels voor het account waarvoor ze worden uitgegeven.

Voor openbaar blootgestelde toepassingen wordt aangeraden server-naar-servertoegang te gebruiken van Azure Maps REST API's waar deze sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access Signature-token dat wordt gemaakt op basis van de bewerking List SAS op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd voor toegang met op rollen gebaseerd toegangsbeheer van Azure en gedetailleerd beheer tot de vervaldatum, snelheid en regio(s) van gebruik voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen toe te staan toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar blootgestelde toepassingen wordt aangeraden een specifieke lijst met toegestane origins te configureren voor de resource van het Account toewijzen om het genereren van misbruik te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

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
      }
    }
  ]
}

Definities

FeaturesItemTypeEnum

Hiermee geeft u het GeoJSON type. Het enige ondersteunde objecttype is Functie. Voor meer informatie, zie RFC 7946.

FeatureTypeEnum

Hiermee geeft u het GeoJSON type. Het enige ondersteunde objecttype is FeatureCollection. Voor meer informatie, zie RFC 7946.

GeoJsonPoint

Een geldig GeoJSON Point geometrietype. Raadpleeg RFC 7946- voor meer informatie.

InputSnapToRoadsFeaturesItem

Hiermee geeft u de invoer-uitlijning op wegenpunten. GeoJSON functieobject en aanvullende eigenschappen. Raadpleeg RFC 7946 voor meer informatie.

MapsErrorDetail

De foutdetails.

MapsErrorResponse

Veelvoorkomende foutreacties voor Azure Maps-API's voor het retourneren van foutdetails voor mislukte bewerkingen.

MapsInnerError

Een object met meer specifieke informatie dan het huidige object over de fout.

PointGeometry

Het oorspronkelijke punt dat wordt doorgegeven als een geldig GeoJSON Geometrieobject, waaruit het bereik veelhoek moet worden berekend. Raadpleeg RFC 7946- voor meer informatie.

Note: de API zal het aangevraagde oorsprongspunt uitlijnen op het dichtstbijzijnde wegennetwerk en dat gebruiken voor bereikberekening. Het wordt geretourneerd als een center punt in het antwoord.

SnapToRoadFeaturesItem

GeoJSON-functieobject dat geometrieobject en aanvullende eigenschappen van de route bevat.

SnapToRoadsFeatureProperties

Uitlijnen op de eigenschappen Van wegen.

SnapToRoadsRequest

Dit object is de hoofdtekst van de aanvraag.

SnapToRoadsResponse

Dit object wordt geretourneerd vanuit een geslaagde aanroep.

SnapToRoadsTravelModeEnum

Hiermee geeft u het routeringsprofiel voor het vastmaken van de punten. Als dit niet is opgegeven, is de standaardmodus 'rijden', waarmee de vastgepakte punten voor rijroutes worden geoptimaliseerd.