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 Routingverfügbarkeit in Ländern/Regionen finden Sie unter Azure Maps-Routingabdeckung.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string	Versionsnummer der Azure Maps-API.

Anforderungsheader

Media Types: "application/geo+json"

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Gibt das Konto an, das für die Verwendung mit dem Microsoft Entra ID-Sicherheitsmodell vorgesehen ist. Diese eindeutige ID für das Azure Maps-Konto kann über die Konto-API der Azure Maps-Verwaltungsebene abgerufen werden. Weitere Informationen zur Verwendung der Microsoft Entra ID-Sicherheit in Azure Maps finden Sie unter Verwalten der Authentifizierung 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	OKAY Media Types: "application/geo+json", "application/json"
Other Status Codes	MapsErrorResponse	Ein unerwarteter Fehler ist aufgetreten. Media Types: "application/geo+json", "application/json" Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

RouteRangeResponse

OKAY

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

Other Status Codes

MapsErrorResponse

Ein unerwarteter Fehler ist aufgetreten.

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

Header

x-ms-error-code: string

Sicherheit

AADToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. Bei Kombination mit rollenbasierten Azure-Zugriff Steuern kann es verwendet werden, um den Zugriff auf Azure Maps-REST-APIs zu steuern. Azure-rollenbasierte Zugriffssteuerungen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jedem Benutzer, Gruppen- oder Dienstprinzipal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht, Zugriff gewährt werden.

Um Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepteanzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte, die zugriffsfähig für bestimmte APIs und Bereiche sind.

Hinweis

Diese Sicherheitsdefinition erfordert die Verwendung des x-ms-client-id-Headers, um anzugeben, auf welche Azure Maps-Ressource die Anwendung Zugriff anfordert. Dies kann über die Karten-Verwaltungs-APIerworben werden.
Die Authorization URL ist spezifisch für die Öffentliche Azure-Cloudinstanz. Souveräne Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra-ID-Konfigurationen.
Die rollenbasierte Azure-Zugriffssteuerung wird über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.
Die Verwendung des Azure Maps Web SDK ermöglicht das konfigurationsbasierte Einrichten einer Anwendung für mehrere Anwendungsfälle.
Weitere Informationen zur Microsoft Identity Platform finden Sie unter Übersicht über die Microsoft Identity Platform.

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

Bereiche

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

subscription-key

Dies ist ein gemeinsam genutzter Schlüssel, der beim Erstellen einer Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs bereitgestellt wird.

Mit diesem Schlüssel ist jede Anwendung berechtigt, auf alle REST-APIs zuzugreifen. Mit anderen Worten, diese können derzeit als Hauptschlüssel für das Konto behandelt werden, für das sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, den Server-zu-Server-Zugriff von Azure Maps-REST-APIs zu verwenden, bei denen dieser Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: header

SAS Token

Dies ist ein Freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und feinkörniger Kontrolle auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token autorisiert. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen das Steuern des Zugriffs auf eine sicherere Weise zu ermöglichen als der freigegebene Schlüssel.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge auf der Zuordnungskontoressource zu konfigurieren,, um das Rendern von 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 https://atlas.microsoft.com/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.
InputRouteRangeProperties	Gibt die Parameter an, die für die Berechnung des isochronen Polygons verwendet werden sollen.
MapsErrorDetail	Das Fehlerdetails.
MapsErrorResponse	Häufige Fehlerantwort für Azure Maps-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben.
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. Beispiel: "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. 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.

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.

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) minimum: 0 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) minimum: 0 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

Häufige Fehlerantwort für Azure Maps-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben.

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.

Beispiel: "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. 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.

Wert	Beschreibung
USHazmatClass1	Sprengstoff
USHazmatClass2	Komprimiertes Gas
USHazmatClass3	Brennbare Flüssigkeiten
USHazmatClass4	Brennbare Feststoffe
USHazmatClass5	Oxidizer
USHazmatClass6	Gifte
USHazmatClass7	Radioaktiv
USHazmatClass8	Beizmittel
USHazmatClass9	Verschiedenes
otherHazmatExplosive	Sprengstoff
otherHazmatGeneral	Verschiedenes
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

InputRouteRangeProperties

MapsErrorDetail

MapsErrorResponse

MapsInnerError

RouteRangeAvoidEnum

RouteRangeFeatureProperties

RouteRangeFeaturesItem

RouteRangeOptimizeRouteEnum

RouteRangePointGeometry

RouteRangePolygonGeometry

RouteRangeRequest

RouteRangeResponse

RouteRangeTravelModeEnum

RouteRangeTypeEnum

RouteRangeVehicleSpec

VehicleLoadTypeEnum