Route - Post Route Range

Dienst:: Maps

API-Version:: 2025-01-01

Die Routenbereichs-API erstellt ein Polygon, das den Bereich darstellt, der von einer bestimmten Position innerhalb eines bestimmten Schwellenwerts basierend auf dem angegebenen Zeit- oder Entfernungsbudget erreicht werden kann. Eine Polygongrenze (oder Isochrone) wird in einer gegen den Uhrzeigersinn ausgerichteten Ausrichtung sowie der genauen Polygonmitte zurückgegeben, die das Ergebnis des Ursprungspunkts war.

Das zurückgegebene Polygon kann für die räumliche Filterung verwendet werden, um nach interessanten Merkmalen innerhalb der bereitgestellten Isochrone zu suchen.

Informationen zur Routing-Verfügbarkeit in Ländern/Regionen finden Sie unter Azure Maps Routing-Abdeckung.

POST {endpoint}/route/range?api-version=2025-01-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Media Types: "application/geo+json"

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt das Konto an, das für die Nutzung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann aus der Azure Maps Management-Plane-Konto-API abgerufen werden. Weitere Informationen zur Nutzung Microsoft Entra ID Sicherheit in Azure Maps finden Sie unter Authentifizierung verwalten in Azure Maps.

Anforderungstext

Media Types: "application/geo+json"

Name	Erforderlich	Typ	Beschreibung
geometry	True	RouteRangePointGeometry	Gibt das `GeoJSON` Point Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.
properties	True	InputRouteRangeProperties	Gibt die Parameter an, die für die Berechnung des isochronen Polygons verwendet werden sollen.
type	True	FeaturesItemTypeEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist Feature. Weitere Informationen finden Sie unter RFC 7946.

Antworten

Name	Typ	Beschreibung
200 OK	RouteRangeResponse	Die Anforderung ist erfolgreich. Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Unerwartete Fehlerantwort. Media Types: "application/geo+json", "application/json"

Name

Typ

Beschreibung

200 OK

RouteRangeResponse

Die Anforderung ist erfolgreich.

Media Types: "application/geo+json", "application/json"

Other Status Codes

MapsErrorResponse

Unerwartete Fehlerantwort.

Media Types: "application/geo+json", "application/json"

Sicherheit

AadToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. In Kombination mit Azure rollenbasierten Zugriffs Steuerung kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Azure-rollenbasierte Zugriffskontrollen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jeder Benutzer, jede Gruppe oder jeder Service-Principal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle erhalten, die aus einer oder mehreren Berechtigungen besteht, REST-APIs zu Azure Maps.\n\nUm Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepte anzusehen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zur Modellierung von Anwendungen über Objekte, die Zugriff auf spezifische APIs und Scopes ermöglichen.\n\n#### Anmerkungen\n* Diese Sicherheitsdefinition re die Verwendung des x-ms-client-id Headers, um anzuzeigen, auf welche Azure Maps Ressource die Anwendung Zugriff bittet. Dies kann über die Maps Management API erworben werden.\n* \nDas Authorization URL ist spezifisch für die Azure Public Cloud-Instanz. Souveräne Clouds verfügen über einzigartige Autorisierungs-URLs und Microsoft Entra ID-Konfigurationen. \n* \nDie Azure rollenbasierte Zugriffskontrolle wird von der Azure Managementebene über Azure Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.\n* \nNutzung der Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.\n* Für weitere Informationen zu Microsoft Identity Platform siehe Microsoft Identity Platform Übersicht.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://atlas.microsoft.com/.default

subscription-key

Dies ist ein gemeinsamer Schlüssel, der bereitgestellt wird, wenn Sie ein Azure Maps Konto im Azure Portal oder mit PowerShell, CLI, Azure SDKs oder REST API erstellen.\n\n Mit diesem Schlüssel kann jede Anwendung auf alle REST-APIs zugreifen. Mit anderen Worten: Dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgegeben werden.\n\n Für öffentlich zugängliche Anwendungen empfehlen wir, den Ansatz confidential Client Applications zu verwenden, um auf Azure Maps REST-APIs zuzugreifen, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: header

SAS Token

Dies ist ein Shared-Access-Signaturtoken, das aus der List SAS-Operation auf der Azure Maps Ressource über die Azure Managementebene über Azure Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt wird.\n\n Mit diesem Token ist jede Anwendung autorisiert, mit Azure rollenbasierte Zugriffskontrollen und feine Kontrolle über Ablauf, Rate und Nutzungsregion des jeweiligen Tokens. Mit anderen Worten: Der SAS-Token kann verwendet werden, um Anwendungen die Zugriffskontrolle auf sicherere Weise als der gemeinsame Schlüssel zu ermöglichen.\n\n Für öffentlich zugängliche Anwendungen empfehlen wir, eine spezielle Liste erlaubter Ursprünge auf der Map-Konto-Ressource zu konfigurieren, um Rendering-Missbrauch zu begrenzen, und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Successfully retrieve a set of locations that can be reached from the origin point based on the specified conditions

Beispielanforderung

HTTP

POST {endpoint}/route/range?api-version=2025-01-01

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      5.86605,
      50.9745
    ]
  },
  "properties": {
    "timeBudgetInSec": 6000
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          5.86605,
          50.9745
        ]
      },
      "properties": {
        "type": "center"
      }
    },
    {
      "type": "Feature",
      "bbox": [
        3.62838,
        49.83259,
        7.9826,
        52.25674
      ],
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              5.73602,
              52.03704
            ],
            [
              5.59435,
              52.09456
            ],
            [
              5.42279,
              52.16815
            ],
            [
              5.21276,
              52.25047
            ],
            [
              5.15355,
              52.21374
            ],
            [
              4.96687,
              52.25674
            ],
            [
              4.739,
              52.07834
            ],
            [
              4.72513,
              52.05647
            ],
            [
              4.53237,
              51.94553
            ],
            [
              4.31165,
              51.70119
            ],
            [
              4.28917,
              51.5837
            ],
            [
              3.82685,
              51.48463
            ],
            [
              3.62838,
              51.21096
            ],
            [
              3.89244,
              50.6814
            ],
            [
              3.93493,
              50.66791
            ],
            [
              3.98156,
              50.49042
            ],
            [
              4.47995,
              50.30944
            ],
            [
              4.60502,
              50.24448
            ],
            [
              4.89999,
              50.24467
            ],
            [
              5.04206,
              50.08735
            ],
            [
              5.23042,
              49.99214
            ],
            [
              5.40994,
              49.88478
            ],
            [
              5.46178,
              49.85797
            ],
            [
              5.7196,
              49.86279
            ],
            [
              5.74151,
              49.83259
            ],
            [
              5.9387,
              50.22239
            ],
            [
              6.08535,
              50.0011
            ],
            [
              6.12089,
              50.04616
            ],
            [
              6.28373,
              50.09472
            ],
            [
              6.51654,
              49.95863
            ],
            [
              6.61034,
              50.00485
            ],
            [
              6.70295,
              50.00587
            ],
            [
              6.65865,
              50.2947
            ],
            [
              6.79276,
              50.36903
            ],
            [
              7.32163,
              50.31614
            ],
            [
              7.58782,
              50.36737
            ],
            [
              7.7626,
              50.46919
            ],
            [
              7.9826,
              50.96246
            ],
            [
              7.55924,
              51.07086
            ],
            [
              7.58138,
              51.36614
            ],
            [
              7.67861,
              51.52015
            ],
            [
              7.35175,
              51.65781
            ],
            [
              7.21664,
              51.81916
            ],
            [
              7.0467,
              51.9587
            ],
            [
              6.67267,
              51.82713
            ],
            [
              6.48424,
              51.81133
            ],
            [
              6.27316,
              51.9368
            ],
            [
              6.14452,
              52.01701
            ],
            [
              6.09312,
              52.20847
            ],
            [
              6.01297,
              52.23705
            ],
            [
              5.86605,
              50.9745
            ],
            [
              5.73602,
              52.03704
            ]
          ]
        ]
      },
      "properties": {
        "type": "boundary"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AdrTunnelRestrictionCodeEnum	Der ADR-Tunneleinschränkungscode. ADR ist ein europäisches Abkommen über die internationale Beförderung gefährlicher Güter auf der Straße. Der ADR-Tunneleinschränkungscode wird verwendet, um zu bestimmen, ob ein Fahrzeug durch einen Tunnel mit Einschränkungen bei der Beförderung gefährlicher Güter durchfahren darf.
FeaturesItemTypeEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist Feature. Weitere Informationen finden Sie unter RFC 7946.
FeatureTypeEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist `FeatureCollection`. Weitere Informationen finden Sie unter RFC 7946.
GeoJsonObjectType	Gibt den `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.
InputRouteRangeProperties	Gibt die Parameter an, die für die Berechnung des isochronen Polygons verwendet werden sollen.
MapsErrorDetail	Das Fehlerdetails.
MapsErrorResponse	Übliche Fehlerantwort für Azure Maps-APIs zur Rückgabe von Fehlerdetails bei fehlgeschlagenen Operationen.
MapsInnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
RouteRangeAvoidEnum	Gibt Einschränkungen an, die bei der Ermittlung der erreichbaren Standorte berücksichtigt werden sollen. Vermeiden Sie die Unterstützung mehrerer Werte in einer Anforderung. \n\nBeispiel: "avoid": ["limitedAccessHighways", "tollRoads"]
RouteRangeFeatureProperties	Eigenschaften von Route Ranges.
RouteRangeFeaturesItem	GeoJSON-Featureobjekt, das Geometry-Objekt und zusätzliche Eigenschaften der Route enthält.
RouteRangeOptimizeRouteEnum	Gibt den Parameter an, der zum Optimieren der Route verwendet werden soll. Wenn nicht definiert, ist der Standardwert "fastestWithoutTraffic", der die Route zurückgibt, um die Fahrzeit zu minimieren, ohne aktuelle Verkehrsinformationen zu verwenden. Beispiel: "optimizeRoute":"shortest"
RouteRangePointGeometry	Gibt das `GeoJSON` Point Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.
RouteRangePolygonGeometry	Gibt das `GeoJSON` Polygon Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.
RouteRangeRequest	Gibt den Ausgangspunkt für die Bereichsberechnung an. `GeoJSON` Featureobjekt und zusätzliche Eigenschaften. Ausführliche Informationen finden Sie unter RFC 7946-.
RouteRangeResponse	Dieses Objekt wird von einem erfolgreichen Aufruf zurückgegeben.
RouteRangeTravelModeEnum	Gibt das Reiseprofil an, das beim Berechnen des Bereichs polygons berücksichtigt werden soll. Wenn nicht angegeben, lautet der Standardwert "Driving". Beispiel: "travelMode":"driving"
RouteRangeTypeEnum	Die Featuretypen für die in der Antwort zurückgegebenen Featureobjekte.
RouteRangeVehicleSpec	Gibt die Fahrzeugattribute wie Fahrzeughöhe, Gewicht, Höchstgeschwindigkeit, Frachttyp usw. an, die bei der Berechnung der erreichbaren Standorte berücksichtigt werden sollen. Dies trägt dazu bei, geringe Brückenabstände, Straßeneinschränkungen, schwierige Rechtsdrehungen zu vermeiden, um die optimierte Lkw-Route basierend auf den Fahrzeugspezifikationen bereitzustellen. Fahrzeugattribute werden innerhalb der Eigenschaft "vehicleSpec" angegeben.
VehicleLoadTypeEnum	Ladungstypen, die als gefährliche Stoffe eingestuft und von einigen Straßen eingeschränkt werden können.

AdrTunnelRestrictionCodeEnum

Enumeration

Der ADR-Tunneleinschränkungscode. ADR ist ein europäisches Abkommen über die internationale Beförderung gefährlicher Güter auf der Straße. Der ADR-Tunneleinschränkungscode wird verwendet, um zu bestimmen, ob ein Fahrzeug durch einen Tunnel mit Einschränkungen bei der Beförderung gefährlicher Güter durchfahren darf.

Wert	Beschreibung
B	Fahrzeuge mit Code B sind von Straßen mit ADR-Tunnelkategorien B, C, D und E eingeschränkt.
C	Fahrzeuge mit Code C sind von Straßen mit ADR-Tunnelkategorien C, D und E eingeschränkt
D	Fahrzeuge mit Code D sind von Straßen mit ADR-Tunnelkategorien D und E eingeschränkt.
E	Fahrzeuge mit Code E sind von Straßen mit ADR-Tunnelkategorie E eingeschränkt.

FeaturesItemTypeEnum

Enumeration

Gibt den GeoJSON Typ an. Der einzige unterstützte Objekttyp ist Feature. Weitere Informationen finden Sie unter RFC 7946.

Wert	Beschreibung
Feature	Gibt den `GeoJSON` Featureobjekttyp an.

FeatureTypeEnum

Enumeration

Gibt den GeoJSON Typ an. Der einzige unterstützte Objekttyp ist FeatureCollection. Weitere Informationen finden Sie unter RFC 7946.

Wert	Beschreibung
FeatureCollection	Gibt den `GeoJSONFeatureCollection` Objekttyp an.

GeoJsonObjectType

Enumeration

Gibt den GeoJSON Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

Wert	Beschreibung
Point	`GeoJSON Point` Geometrie.
MultiPoint	`GeoJSON MultiPoint` Geometrie.
LineString	`GeoJSON LineString` Geometrie.
MultiLineString	`GeoJSON MultiLineString` Geometrie.
Polygon	`GeoJSON Polygon` Geometrie.
MultiPolygon	`GeoJSON MultiPolygon` Geometrie.
GeometryCollection	`GeoJSON GeometryCollection` Geometrie.
Feature	`GeoJSON Feature`-Objekt
FeatureCollection	`GeoJSON FeatureCollection`-Objekt

InputRouteRangeProperties

Objekt

Gibt die Parameter an, die für die Berechnung des isochronen Polygons verwendet werden sollen.

Name	Typ	Standardwert	Beschreibung
avoid	RouteRangeAvoidEnum[]		Gibt Einschränkungen an, die bei der Ermittlung der erreichbaren Standorte berücksichtigt werden sollen. Vermeiden Sie die Unterstützung mehrerer Werte in einer Anforderung. Beispiel: "avoid": ["limitedAccessHighways", "tollRoads"]
departAt	string (date-time)		Das Datum und die Uhrzeit des Abflugpunkts, der als dateTime-Wert formatiert ist, der durch RFC 3339, Abschnitt 5.6definiert ist. Wenn kein Zeitzonenoffset angegeben wird, wird UTC angenommen. Wenn die `departAt` nicht festgelegt ist, ist der Standardwert die aktuelle Uhrzeit. Beispiel: "departAt": "2023-06-01T09:30:00.000-07:00"
distanceBudgetInMeters	number (float) maximum: 500000		Das Entfernungsbudget gibt den maximalen Bereich in Metern an, der vom Ausgangspunkt entfernt werden kann. Sie kann nicht festgelegt werden, wenn `timeBudgetInSec` angegeben wird. Wenn `isSimplifiedPolygon` false festgelegt ist, beträgt die maximal unterstützte Entfernung 90000 Meter, andernfalls 500.000 Meter. Beispiel: "distanceBudgetInMeters":5000
isSimplifiedPolygon	boolean	True	Verwenden Sie diese Informationen, um anzugeben, ob Sie vereinfachte Polygone benötigen, die die Anzahl der Polygonvertices reduzieren und dabei die Form beibehalten. Die API gibt standardmäßig Polygone mit niedriger Definition zurück.
optimizeRoute	RouteRangeOptimizeRouteEnum	fastestWithoutTraffic	Gibt den Parameter an, der zum Optimieren der Route verwendet werden soll. Wenn nicht definiert, ist der Standardwert "fastestWithoutTraffic", der die Route zurückgibt, um die Fahrzeit zu minimieren, ohne aktuelle Verkehrsinformationen zu verwenden. Beispiel: "optimizeRoute":"shortest"
timeBudgetInSec	number (float) maximum: 21600		Das Zeitbudget gibt die maximale Zeit in Sekunden an, die für die Reise verfügbar ist, und definiert, wie weit man innerhalb dieser Zeitbeschränkung vom Ausgangspunkt gehen kann. Sie kann nicht festgelegt werden, wenn `distanceBudgetInMeters` angegeben wird. Wenn `isSimplifiedPolygon` false festgelegt ist, beträgt die maximal unterstützte Zeit 3600 Sekunden, andernfalls 21.600 Sekunden. Beispiel: "timeBudgetInSec":3600
travelMode	RouteRangeTravelModeEnum	driving	Gibt das Reiseprofil an, das beim Berechnen des Bereichs polygons berücksichtigt werden soll. Wenn nicht angegeben, lautet der Standardwert "Driving". Beispiel: "travelMode":"driving"
vehicleSpec	RouteRangeVehicleSpec		Gibt die Fahrzeugattribute wie Fahrzeughöhe, Gewicht, Höchstgeschwindigkeit, Frachttyp usw. an, die bei der Berechnung der erreichbaren Standorte berücksichtigt werden sollen. Dies trägt dazu bei, geringe Brückenabstände, Straßeneinschränkungen, schwierige Rechtsdrehungen zu vermeiden, um die optimierte Lkw-Route basierend auf den Fahrzeugspezifikationen bereitzustellen. Fahrzeugattribute werden innerhalb der Eigenschaft "vehicleSpec" angegeben.

MapsErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	MapsErrorDetail[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	MapsInnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

MapsErrorResponse

Objekt

Übliche Fehlerantwort für Azure Maps-APIs zur Rückgabe von Fehlerdetails bei fehlgeschlagenen Operationen.

Name	Typ	Beschreibung
error	MapsErrorDetail	Das Fehlerdetails.

MapsInnerError

Objekt

Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
innererror	MapsInnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.

RouteRangeAvoidEnum

Enumeration

Gibt Einschränkungen an, die bei der Ermittlung der erreichbaren Standorte berücksichtigt werden sollen. Vermeiden Sie die Unterstützung mehrerer Werte in einer Anforderung. \n\nBeispiel: "avoid": ["limitedAccessHighways", "tollRoads"]

Wert	Beschreibung
limitedAccessHighways	Vermeidet die Verwendung begrenzter Zugangsstraßen in der Route.
tollRoads	Vermeidet die Nutzung der mautpflichtigen Straßen auf der Route.
ferries	Vermeidet die Verwendung von Fähren auf der Route.
tunnels	Verhindert die Verwendung von Tunneln in der Route.
borderCrossings	Verhindert die Grenzüberquerung der Länder in der Route.
lowEmissionZones	Vermeidet emissionsarme Zonen in der Route.
unpavedRoads	Vermeidet nicht gepavte Straßen in der Route.
carpools	Vermeidet Routen, die die Nutzung von Fahrgemeinschaften erfordern.
carTrains	Vermeidet Autozüge.

RouteRangeFeatureProperties

Objekt

Eigenschaften von Route Ranges.

Name	Typ	Beschreibung
type	RouteRangeTypeEnum	Die Featuretypen für die in der Antwort zurückgegebenen Featureobjekte.

RouteRangeFeaturesItem

Objekt

GeoJSON-Featureobjekt, das Geometry-Objekt und zusätzliche Eigenschaften der Route enthält.

Name	Typ	Beschreibung
bbox	number[] (double)	Ein rechteckiger Bereich auf der Erde, der als umgebendes Boxobjekt definiert ist. Die Seiten der Rechtecke werden durch Breiten- und Längengradwerte definiert. Weitere Informationen finden Sie unter RFC 7946, Abschnitt 5. Beispiel: "bbox": [-10.0, -10.0, 10.0, 10.0]
geometry	RouteRangeGeometry: RouteRangePointGeometry RouteRangePolygonGeometry	Ein gültiges `GeoJSON` Geometry-Objekt. Weitere Informationen finden Sie unter RFC 7946-.
properties	RouteRangeFeatureProperties	Eigenschaften von Route Ranges.
type	FeaturesItemTypeEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist Feature. Weitere Informationen finden Sie unter RFC 7946.

RouteRangeOptimizeRouteEnum

Enumeration

Gibt den Parameter an, der zum Optimieren der Route verwendet werden soll. Wenn nicht definiert, ist der Standardwert "fastestWithoutTraffic", der die Route zurückgibt, um die Fahrzeit zu minimieren, ohne aktuelle Verkehrsinformationen zu verwenden.

Beispiel: "optimizeRoute":"shortest"

Wert	Beschreibung
shortest	Die Route wird berechnet, um die Entfernung zu minimieren. Datenverkehrsinformationen werden nicht verwendet.
fastestWithoutTraffic	Findet die schnellste Route, ohne die Verkehrsinformationen zu berücksichtigen.
fastestWithTraffic	Die Route wird berechnet, um die Zeit mithilfe der aktuellen Datenverkehrsinformationen zu minimieren. `Note`: Wird nur für Fahr- und Lkw-Reisemode unterstützt.

RouteRangePointGeometry

Objekt

Gibt das GeoJSON Point Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Ein `Position` ist ein Array von Zahlen mit zwei oder mehr Elementen. Die ersten beiden Elemente sind Längengrad und Breitengradgenau in dieser Reihenfolge. Altitude/Elevation ist ein optionales drittes Element. Weitere Informationen finden Sie unter RFC 7946-.
type	string: Point	Gibt den Geometrietyp für das `GeoJSON` Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.

RouteRangePolygonGeometry

Objekt

Gibt das GeoJSON Polygon Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
coordinates	number[] (double)	Koordinaten für den geometrietyp `GeoJson Polygon`.
type	string: Polygon	Gibt den Geometrietyp für das `GeoJSON` Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.

RouteRangeRequest

Objekt

Gibt den Ausgangspunkt für die Bereichsberechnung an. GeoJSON Featureobjekt und zusätzliche Eigenschaften. Ausführliche Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
geometry	RouteRangePointGeometry	Gibt das `GeoJSON` Point Geometry -Objekt an. Ausführliche Informationen finden Sie unter RFC 7946-.
properties	InputRouteRangeProperties	Gibt die Parameter an, die für die Berechnung des isochronen Polygons verwendet werden sollen.
type	FeaturesItemTypeEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist Feature. Weitere Informationen finden Sie unter RFC 7946.

RouteRangeResponse

Objekt

Dieses Objekt wird von einem erfolgreichen Aufruf zurückgegeben.

Name	Typ	Beschreibung
features	RouteRangeFeaturesItem[]	`GeoJSON` Featureobjekt, das Geometry-Objekt und zusätzliche Eigenschaften enthält. Ausführliche Informationen finden Sie unter RFC 7946, Abschnitt 3.2.
type	FeatureTypeEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist `FeatureCollection`. Weitere Informationen finden Sie unter RFC 7946.

RouteRangeTravelModeEnum

Enumeration

Gibt das Reiseprofil an, das beim Berechnen des Bereichs polygons berücksichtigt werden soll. Wenn nicht angegeben, lautet der Standardwert "Driving".

Beispiel: "travelMode":"driving"

Wert	Beschreibung
driving	Routingprofil, das für Autos geeignet ist, werden für die Bereichs-Polygonberechnung verwendet.
truck	Routingprofil, das für Nutzfahrzeuge wie Lkw geeignet ist, werden für die Polygonberechnung des Bereichs verwendet.

RouteRangeTypeEnum

Enumeration

Die Featuretypen für die in der Antwort zurückgegebenen Featureobjekte.

Wert	Beschreibung
center	Der Mittelpunktspunkt-Featuretyp stellt den Punkt dar, der für die Berechnung des Bereichspolycks verwendet wird.
boundary	Der Randfeaturetyp stellt das Bereichspolyck dar.

RouteRangeVehicleSpec

Objekt

Gibt die Fahrzeugattribute wie Fahrzeughöhe, Gewicht, Höchstgeschwindigkeit, Frachttyp usw. an, die bei der Berechnung der erreichbaren Standorte berücksichtigt werden sollen. Dies trägt dazu bei, geringe Brückenabstände, Straßeneinschränkungen, schwierige Rechtsdrehungen zu vermeiden, um die optimierte Lkw-Route basierend auf den Fahrzeugspezifikationen bereitzustellen. Fahrzeugattribute werden innerhalb der Eigenschaft "vehicleSpec" angegeben.

Name	Typ	Standardwert	Beschreibung
adrTunnelRestrictionCode	AdrTunnelRestrictionCodeEnum		Der ADR-Tunneleinschränkungscode. ADR ist ein europäisches Abkommen über die internationale Beförderung gefährlicher Güter auf der Straße. Der ADR-Tunneleinschränkungscode wird verwendet, um zu bestimmen, ob ein Fahrzeug durch einen Tunnel mit Einschränkungen bei der Beförderung gefährlicher Güter durchfahren darf.
axleCount	integer (int64)		Die Anzahl der Achsen auf dem Fahrzeug.
axleWeight	integer (int64) minimum: 0 maximum: 1000000	0	Gewicht pro Achse des Fahrzeugs in kg. Der Wert 0 bedeutet, dass Gewichtseinschränkungen pro Achse nicht berücksichtigt werden.
height	number (double) minimum: 0 maximum: 1000000	0	Höhe des Fahrzeugs in Metern. Ein Wert von 0 bedeutet, dass Höheneinschränkungen nicht berücksichtigt werden.
isVehicleCommercial	boolean	False	Ob das Fahrzeug für gewerbliche Zwecke verwendet wird. Nutzfahrzeuge dürfen auf einigen Straßen möglicherweise nicht fahren.
length	number (double) minimum: 0 maximum: 1000000	0	Länge des Fahrzeugs in Metern. Ein Wert von 0 bedeutet, dass Längenbeschränkungen nicht berücksichtigt werden.
loadType	VehicleLoadTypeEnum[]		Ladungstypen, die als gefährliche Stoffe eingestuft und von einigen Straßen eingeschränkt werden können. Verfügbare vehicleLoadType-Werte sind US Hazmat Klassen 1 bis 9 sowie generische Klassifizierungen für die Verwendung in anderen Ländern. Werte, die mit USHazmat beginnen, gelten für US-Routing, während andereHazmat für alle anderen Länder verwendet werden sollten. vehicleLoadType unterstützt mehrere Werte in einer Anforderung.
maxSpeed	integer (int64) minimum: 0 maximum: 250	0	Maximale Geschwindigkeit des Fahrzeugs in km/Stunde. Die Höchstgeschwindigkeit im Fahrzeugprofil wird verwendet, um zu überprüfen, ob ein Fahrzeug auf Autobahnen erlaubt ist. Ein Wert von 0 bedeutet, dass bei der Routenplanung ein entsprechender Wert für das Fahrzeug bestimmt und angewendet wird. Ein Wert ungleich Null kann während der Routenplanung außer Kraft gesetzt werden. Beispielsweise beträgt der aktuelle Verkehrsfluss 60 km/Stunde. Wenn die Maximale Geschwindigkeit des Fahrzeugs auf 50 km/Stunde festgelegt ist, berücksichtigt der Routingmotor 60 km/Stunde, da dies die aktuelle Situation ist. Wenn die maximale Geschwindigkeit des Fahrzeugs als 80 km/Stunde angegeben wird, aber der aktuelle Verkehrsfluss 60 km/Stunde beträgt, wird der Routingmotor erneut 60 km/Stunde verwenden.
weight	integer (int64) minimum: 0 maximum: 1000000	0	Gewicht des Fahrzeugs in Kilogramm. Ein Wert von 0 bedeutet, dass Gewichtseinschränkungen nicht berücksichtigt werden.
width	number (double) minimum: 0 maximum: 1000000	0	Breite des Fahrzeugs in Metern. Ein Wert von 0 bedeutet, dass Breiteseinschränkungen nicht berücksichtigt werden.

VehicleLoadTypeEnum

Enumeration

Ladungstypen, die als gefährliche Stoffe eingestuft und von einigen Straßen eingeschränkt werden können.

Wert	Beschreibung
USHazmatClass1	Sprengstoff
USHazmatClass2	Komprimiertes Gas
USHazmatClass3	Brennbare Flüssigkeiten
USHazmatClass4	Brennbare Feststoffe
USHazmatClass5	Oxidizer
USHazmatClass6	Gifte
USHazmatClass7	Radioaktiv
USHazmatClass8	Beizmittel
USHazmatClass9	Miscellaneous
otherHazmatExplosive	Sprengstoff
otherHazmatGeneral	Miscellaneous
otherHazmatHarmfulToWater	Schädlich für Wasser

Freigeben über

Route - Post Route Range

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

AadToken

Bereiche

subscription-key

SAS Token

Beispiele

Successfully retrieve a set of locations that can be reached from the origin point based on the specified conditions

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AdrTunnelRestrictionCodeEnum

FeaturesItemTypeEnum

FeatureTypeEnum

GeoJsonObjectType

InputRouteRangeProperties

MapsErrorDetail

MapsErrorResponse

MapsInnerError

RouteRangeAvoidEnum

RouteRangeFeatureProperties

RouteRangeFeaturesItem

RouteRangeOptimizeRouteEnum

RouteRangePointGeometry

RouteRangePolygonGeometry

RouteRangeRequest

RouteRangeResponse

RouteRangeTravelModeEnum

RouteRangeTypeEnum

RouteRangeVehicleSpec

VehicleLoadTypeEnum