Search - Get Reverse Geocoding

Dienst:: Maps

API-Version:: 2026-01-01

Verwenden Sie diese Option, um eine Straßenadresse und Standortinformationen aus Längen- und Breitengradkoordinaten abzurufen.
Die Get Reverse Geocoding-API ist eine HTTP-GET-Anforderung, die verwendet wird, um eine Koordinate (Beispiel: 37.786505, -122.3862) in eine menschlichen verständlichen Straßenadresse zu übersetzen. Nützlich bei der Nachverfolgung von Anwendungen, in denen Sie einen GPS-Feed vom Gerät oder Objekt erhalten und die Adresse kennen möchten, die den Koordinaten zugeordnet ist. Dieser Endpunkt gibt Adressinformationen für eine bestimmte Koordinate zurück.

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}

Mit optionalen Parametern:

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

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.
coordinates	query	True	number[]	Die Koordinaten des Standorts, den Sie umkehren möchten. Beispiel: &Koordinaten=lon,lat
resultTypes	query		ReverseGeocodingResultTypeEnum[]	Geben Sie Entitätstypen an, die in der Antwort angezeigt werden sollen. Nur die von Ihnen angegebenen Typen werden zurückgegeben. Wenn der Punkt nicht den von Ihnen angegebenen Entitätstypen zugeordnet werden kann, werden keine Standortinformationen in der Antwort zurückgegeben. Der Standardwert ist alle möglichen Entitäten. Eine durch Trennzeichen getrennte Liste von Entitätstypen, die aus den folgenden Optionen ausgewählt sind. Adresse Nachbarschaft Aufgefüllter Platz Postleitzahl1 AdminDivision1 AdminDivision2 Land/Region Diese Entitätstypen werden von der spezifischsten Entität bis zur am wenigsten spezifischen Entität sortiert. Wenn Entitäten von mehr als einem Entitätstyp gefunden werden, wird nur die spezifischste Entität zurückgegeben. Wenn Sie beispielsweise Address und AdminDistrict1 als Entitätstypen und Entitäten für beide Typen angeben, werden nur die Adressentitätsinformationen in der Antwort zurückgegeben.
view	query		string	Eine Zeichenfolge, die einen ISO 3166-1 Alpha-2-Regions-/Ländercode darstellt. Dies wird geopolitische umstrittene Grenzen und Bezeichnungen ändern, um sie an die angegebene Benutzerregion auszurichten. Der Parameter „View“ ist standardmäßig auf „Auto“ festgelegt, auch wenn Sie ihn in der Anforderung nicht definiert haben. Weitere Informationen finden Sie unter Unterstützten Ansichten und die verfügbaren Ansichten.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-id		string	Spezifiziert, welches Konto für die Nutzung in Verbindung mit dem Azure-AD-Sicherheitsmodell vorgesehen ist. Es stellt eine eindeutige ID für das Azure Maps-Konto dar und kann aus der Azure Maps-Verwaltungsebene-Account API abgerufen werden. Weitere Informationen zur Nutzung Microsoft Entra ID Sicherheit in Azure Maps finden Sie unter Authentifizierung verwalten in Azure Maps.
Accept-Language		string	Sprache, in der Suchergebnisse zurückgegeben werden sollen. Weitere Informationen finden Sie unter unterstützten Sprachen.

Name

Erforderlich

Typ

Beschreibung

x-ms-client-id

string

Spezifiziert, welches Konto für die Nutzung in Verbindung mit dem Azure-AD-Sicherheitsmodell vorgesehen ist. Es stellt eine eindeutige ID für das Azure Maps-Konto dar und kann aus der Azure Maps-Verwaltungsebene-Account API abgerufen werden. Weitere Informationen zur Nutzung Microsoft Entra ID Sicherheit in Azure Maps finden Sie unter Authentifizierung verwalten in Azure Maps.

Accept-Language

string

Sprache, in der Suchergebnisse zurückgegeben werden sollen.

Weitere Informationen finden Sie unter unterstützten Sprachen.

Antworten

Name	Typ	Beschreibung
200 OK	GeocodingResponse	Die Anforderung ist erfolgreich. Media Types: "application/geo+json", "application/json"
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Media Types: "application/geo+json", "application/json" Header x-ms-error-code: string

Name

Typ

Beschreibung

200 OK

GeocodingResponse

Die Anforderung ist erfolgreich.

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

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Unerwartete Fehlerantwort.

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

Header

x-ms-error-code: string

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

Search point -122.138681, 47.630358

Beispielanforderung

HTTP

GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates=-122.138681,47.630358

Beispiel für eine Antwort

Statuscode:: 200

Content-Type: application/geo+json

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "address": {
          "countryRegion": {
            "name": "United States"
          },
          "adminDistricts": [
            {
              "name": "Washington",
              "shortName": "WA"
            },
            {
              "name": "King County",
              "shortName": "King Co."
            }
          ],
          "formattedAddress": "15127 NE 24th St, Redmond, Washington 98052",
          "streetName": "NE 24th St",
          "streetNumber": "15127",
          "locality": "Redmond",
          "postalCode": "98052",
          "addressLine": "15127 NE 24th St"
        },
        "type": "Address",
        "confidence": "Medium",
        "matchCodes": [
          "Good"
        ],
        "geocodePoints": [
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.138681,
                47.630358
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Display"
            ]
          },
          {
            "geometry": {
              "type": "Point",
              "coordinates": [
                -122.1386787,
                47.6302179
              ]
            },
            "calculationMethod": "Rooftop",
            "usageTypes": [
              "Route"
            ]
          }
        ]
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.138681,
          47.630358
        ]
      },
      "bbox": [
        -122.14632282407,
        47.626495282429325,
        -122.13103917593001,
        47.63422071757068
      ]
    }
  ]
}

Definitionen

Name	Beschreibung
Address	Die Adresse des Ergebnisses
AddressAdminDistrictsItem	Der Unterteilungsname im Land oder der Region für eine Adresse.
AddressCountryRegion	Land oder Region mit seinem Namen und ISO-Code.
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Laut Azure REST API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.
CalculationMethodEnum	Die Methode, die zum Berechnen des Geocodepunkts verwendet wurde.
ConfidenceEnum	Das Konfidenzniveau, dass das geocodierte Standortergebnis eine Übereinstimmung ist. Verwenden Sie diesen Wert mit dem Übereinstimmungscode, um ausführlichere Informationen zur Übereinstimmung zu ermitteln. Die Konfidenz eines geocodierten Standorts basiert auf vielen Faktoren, einschließlich der relativen Wichtigkeit des geocodierten Standorts und des Standorts des Benutzers, sofern angegeben.
FeatureCollectionEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist `FeatureCollection`. Weitere Informationen finden Sie unter RFC 7946.
FeaturesItem	Ein Merkmalsobjekt.
FeaturesItemProperties	Eigenschaften des Merkmals.
FeatureTypeEnum	Der Typ eines Features muss feature sein.
GeocodePointsItem	Ein Geocode-Punkt.
GeocodingResponse	Dieses Objekt wird von einem erfolgreichen Geocodierungsaufruf zurückgegeben.
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.
GeoJsonPoint	Ein gültiger `GeoJSON Point` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
Intersection	Die Adresse des Ergebnisses.
MatchCodesEnum	Ein Enum, das den Match-Code repräsentiert.
ReverseGeocodingResultTypeEnum	Ein Enum, das den Ergebnistyp der umgekehrten Geokodierung darstellt.
UsageTypeEnum	Ein Enum, das den Nutzungstyp darstellt.

Address

Objekt

Die Adresse des Ergebnisses

Name	Typ	Beschreibung
addressLine	string	AddressLine, die den Straßennamen und die Hausnummer enthält
adminDistricts	AddressAdminDistrictsItem[]	Der Unterteilungsname im Land oder der Region für eine Adresse. Dieses Element wird in der Regel als administrative Unterteilung der ersten Reihenfolge behandelt, enthält aber in einigen Fällen auch die zweite, dritte oder vierte Ordnungsunterteilung in einem Land, einer Abhängigkeit oder region.
countryRegion	AddressCountryRegion	Land oder Region mit seinem Namen und ISO-Code.
formattedAddress	string	Eigenschaft "Formatierte Adresse"
intersection	Intersection	Die Adresse des Ergebnisses.
locality	string	Lokalität Immobilie
neighborhood	string	Immobilie in der Nachbarschaft
postalCode	string	Eigenschaft "Postleitzahl"
streetName	string	Der Name der Straße aus formattedAddress
streetNumber	string	Die Nummer in der Straße, falls verfügbar, von formattedAddress

AddressAdminDistrictsItem

Objekt

Der Unterteilungsname im Land oder der Region für eine Adresse.

Name	Typ	Beschreibung
name	string	Der Name für das entsprechende Feld "adminDistrict", "For adminDistrict[0], this could be full name of state such as Washington, For adminDistrict[1], this could be the full name of the county
shortName	string	Der Kurzname für das entsprechende Feld "adminDistrict", "For adminDistrict[0], this could be short name of state such as WA, For adminDistrict[1], this could be the short name of the county

AddressCountryRegion

Objekt

Land oder Region mit seinem Namen und ISO-Code.

Name	Typ	Beschreibung
ISO	string	ISO des Landes/der Region
name	string	Name des Landes/der Region

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	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.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Laut Azure REST API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

CalculationMethodEnum

Enumeration

Die Methode, die zum Berechnen des Geocodepunkts verwendet wurde.

Wert	Beschreibung
Interpolation	Der Geokodierungspunkt wurde mithilfe der Interpolation mit einem Punkt auf einer Straße abgeglichen.
InterpolationOffset	Der Geokodierungspunkt wurde mithilfe der Interpolation mit einem Punkt auf einer Straße abgeglichen, wobei ein zusätzlicher Versatz hinzugefügt wurde, um den Punkt an die Straßenseite zu verschieben.
Parcel	Der Geokodierungspunkt wurde mit dem Mittelpunkt eines Flurstücks abgeglichen.
Rooftop	Der Geokodierungspunkt wurde mit dem Dach eines Gebäudes abgeglichen.

ConfidenceEnum

Enumeration

Das Konfidenzniveau, dass das geocodierte Standortergebnis eine Übereinstimmung ist. Verwenden Sie diesen Wert mit dem Übereinstimmungscode, um ausführlichere Informationen zur Übereinstimmung zu ermitteln.

Die Konfidenz eines geocodierten Standorts basiert auf vielen Faktoren, einschließlich der relativen Wichtigkeit des geocodierten Standorts und des Standorts des Benutzers, sofern angegeben.

Wert Beschreibung

High

Wert	Beschreibung
High	Wenn die Konfidenz auf `High`festgelegt ist, wurden eine oder mehrere starke Übereinstimmungen gefunden. Mehrere `High` Konfidenzübereinstimmungen werden gegebenenfalls in der Rangfolge nach Wichtigkeit sortiert. Orientierungspunkte sind z. B. wichtig, Adressen jedoch nicht. Wenn eine Anforderung einen Standort oder eine Ansicht enthält, kann sich die Rangfolge entsprechend ändern. Eine Standortabfrage für "Paris" gibt z. B. "Paris, Frankreich" und "Paris, TX" `High` mit Konfidenz zurück. "Paris, Frankreich" wird aufgrund seiner Wichtigkeit immer an erster Stelle eingestuft, es sei denn, ein Benutzerstandort gibt an, dass sich der Benutzer in oder sehr nahe an Paris, TX, befindet, oder die Kartenansicht zeigt an, dass der Benutzer in diesem Gebiet sucht.
Medium	In einigen Situationen kann es vorkommen, dass die zurückgegebene Übereinstimmung nicht auf der gleichen Ebene ist wie die in der Anforderung bereitgestellten Informationen. In einer Anforderung können z. B. Adressinformationen angegeben werden, und der Geokodierungsservice kann nur eine Postleitzahl abgleichen. Wenn der Geokodierungsservice in diesem Fall die Konfidenz hat, dass die Postleitzahl mit den Daten übereinstimmt, wird die Konfidenz auf `Medium` und der Abgleichscode auf festgelegt `UpHierarchy` , um anzugeben, dass nicht alle Informationen übereinstimmen konnten und in der übergeordneten Hierarchie gesucht werden musste. Wenn die Standortinformationen in der Abfrage mehrdeutig sind und keine zusätzlichen Informationen zur Einstufung der Standorte vorhanden sind (z. B. der Standort des Benutzers oder die relative Wichtigkeit des Standorts), wird die Konfidenz auf `Medium`festgelegt. Eine Standortabfrage für "148th Ave, Bellevue" kann z. B. "148th Ave SE" und "148th Ave NE" `Medium` mit Konfidenz zurückgeben. Wenn die Positionsinformationen in der Abfrage nicht genügend Informationen für die Geokodierung einer bestimmten Position liefern, wird möglicherweise ein weniger genauer Positionswert zurückgegeben und die Konfidenz auf `Medium`festgelegt. Wenn z. B. eine Adresse angegeben wird, aber keine Übereinstimmung für die Hausnummer gefunden wird, kann das Geokodierungsergebnis mit dem Entitätstyp Roadblock zurückgegeben werden.
Low	Niedrig

Wenn die Konfidenz auf Highfestgelegt ist, wurden eine oder mehrere starke Übereinstimmungen gefunden. Mehrere High Konfidenzübereinstimmungen werden gegebenenfalls in der Rangfolge nach Wichtigkeit sortiert. Orientierungspunkte sind z. B. wichtig, Adressen jedoch nicht.

Wenn eine Anforderung einen Standort oder eine Ansicht enthält, kann sich die Rangfolge entsprechend ändern. Eine Standortabfrage für "Paris" gibt z. B. "Paris, Frankreich" und "Paris, TX" High mit Konfidenz zurück. "Paris, Frankreich" wird aufgrund seiner Wichtigkeit immer an erster Stelle eingestuft, es sei denn, ein Benutzerstandort gibt an, dass sich der Benutzer in oder sehr nahe an Paris, TX, befindet, oder die Kartenansicht zeigt an, dass der Benutzer in diesem Gebiet sucht.

Medium

In einigen Situationen kann es vorkommen, dass die zurückgegebene Übereinstimmung nicht auf der gleichen Ebene ist wie die in der Anforderung bereitgestellten Informationen. In einer Anforderung können z. B. Adressinformationen angegeben werden, und der Geokodierungsservice kann nur eine Postleitzahl abgleichen. Wenn der Geokodierungsservice in diesem Fall die Konfidenz hat, dass die Postleitzahl mit den Daten übereinstimmt, wird die Konfidenz auf Medium und der Abgleichscode auf festgelegt UpHierarchy , um anzugeben, dass nicht alle Informationen übereinstimmen konnten und in der übergeordneten Hierarchie gesucht werden musste.

Wenn die Standortinformationen in der Abfrage mehrdeutig sind und keine zusätzlichen Informationen zur Einstufung der Standorte vorhanden sind (z. B. der Standort des Benutzers oder die relative Wichtigkeit des Standorts), wird die Konfidenz auf Mediumfestgelegt. Eine Standortabfrage für "148th Ave, Bellevue" kann z. B. "148th Ave SE" und "148th Ave NE" Medium mit Konfidenz zurückgeben.

Wenn die Positionsinformationen in der Abfrage nicht genügend Informationen für die Geokodierung einer bestimmten Position liefern, wird möglicherweise ein weniger genauer Positionswert zurückgegeben und die Konfidenz auf Mediumfestgelegt. Wenn z. B. eine Adresse angegeben wird, aber keine Übereinstimmung für die Hausnummer gefunden wird, kann das Geokodierungsergebnis mit dem Entitätstyp Roadblock zurückgegeben werden.

Low

Niedrig

FeatureCollectionEnum

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.

FeaturesItem

Objekt

Ein Merkmalsobjekt.

Name	Typ	Beschreibung
bbox	number[] (double)	Begrenzungsrahmen. Projektion verwendet - EPSG:3857. Weitere Informationen finden Sie unter RFC 7946-.
geometry	GeoJsonPoint	Ein gültiger `GeoJSON Point` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
id	string	ID für zurückgegebene Funktion
properties	FeaturesItemProperties	Eigenschaften des Merkmals.
type	FeatureTypeEnum	Der Typ eines Features muss feature sein.

FeaturesItemProperties

Objekt

Eigenschaften des Merkmals.

Name	Typ	Beschreibung
address	Address	Die Adresse des Ergebnisses
confidence	ConfidenceEnum	Das Konfidenzniveau, dass das geocodierte Standortergebnis eine Übereinstimmung ist. Verwenden Sie diesen Wert mit dem Übereinstimmungscode, um ausführlichere Informationen zur Übereinstimmung zu ermitteln. Die Konfidenz eines geocodierten Standorts basiert auf vielen Faktoren, einschließlich der relativen Wichtigkeit des geocodierten Standorts und des Standorts des Benutzers, sofern angegeben.
geocodePoints	GeocodePointsItem[]	Eine Sammlung von Geocodepunkten, die sich bei der Berechnung und deren vorgeschlagene Verwendung unterscheiden.
matchCodes	MatchCodesEnum[]	Mindestens ein Übereinstimmungscodewert, der die Geocodierungsebene für jeden Standort in der Antwort darstellt. Beispielsweise bedeutet ein geocodierter Standort mit Übereinstimmungscodes von `Good` und `Ambiguous`, dass für die Standortinformationen mehrere Geocode-Standorte gefunden wurden und dass der Geocode-Dienst keine Suchhierarchie zum Suchen nach einer Übereinstimmung hat. Ebenso bedeutet ein geocodierter Standort mit Übereinstimmungscodes von `Ambiguous` und `UpHierarchy`, dass ein Geocodestandort nicht gefunden werden konnte, der mit allen bereitgestellten Standortinformationen übereinstimmte, sodass der Geocode-Dienst die Hierarchie nach oben durchsuchen und mehrere Übereinstimmungen auf dieser Ebene gefunden hatte. Ein Beispiel für eine `Ambiguous` und `UpHierarchy` Ergebnis ist, wenn Sie vollständige Adressinformationen angeben, der Geocode-Dienst kann jedoch keine Übereinstimmung für die Straßenadresse finden und gibt stattdessen Informationen für mehr als einen RoadBlock-Wert zurück. Mögliche Werte sind: `Good`: Der Standort hat nur eine Übereinstimmung, oder alle zurückgegebenen Übereinstimmungen gelten als starke Übereinstimmungen. Eine Abfrage für New York gibt z. B. mehrere gute Übereinstimmungen zurück. `Ambiguous`: Die Position ist eine der möglichen Übereinstimmungen. Wenn Sie beispielsweise die Straße 128 Main St. abfragen, gibt die Antwort möglicherweise zwei Standorte für 128 North Main St. und 128 South Main St. zurück, da nicht genügend Informationen vorhanden sind, um zu bestimmen, welche Option sie auswählen soll. `UpHierarchy`: Der Standort stellt eine Verschiebung nach oben in der geografischen Hierarchie dar. Dies tritt auf, wenn eine Übereinstimmung für die Standortanforderung nicht gefunden wurde, sodass ein weniger präzises Ergebnis zurückgegeben wird. Wenn beispielsweise eine Übereinstimmung für die angeforderte Adresse nicht gefunden werden kann, kann ein Übereinstimmungscode von `UpHierarchy` mit einem RoadBlock-Entitätstyp zurückgegeben werden.
type	string	Eine von: * Adresse * Straßensperre * Straßenkreuzung * Nachbarschaft * Bewohnter Ort * Postleitzahl1 * AdminDivision1 * AdminDivision2 * LandRegion

FeatureTypeEnum

Enumeration

Der Typ eines Features muss feature sein.

Wert	Beschreibung
Feature	Gibt den `GeoJSON` Featureobjekttyp an.

GeocodePointsItem

Objekt

Ein Geocode-Punkt.

Name	Typ	Beschreibung
calculationMethod	CalculationMethodEnum	Die Methode, die zum Berechnen des Geocodepunkts verwendet wurde.
geometry	GeoJsonPoint	Ein gültiger `GeoJSON Point` Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.
usageTypes	UsageTypeEnum[]	Die beste Verwendung für den Geocodepunkt. Jeder Geocodepunkt wird als `Route` Punkt, ein `Display` Punkt oder beides definiert. Verwenden Sie `Route` Punkte, wenn Sie eine Route zum Standort erstellen. Verwenden Sie `Display` Punkte, wenn Sie die Position auf einer Karte anzeigen. Wenn es sich beispielsweise um einen Park handelt, kann ein `Route` Punkt einen Eingang zum Park angeben, in den Sie mit einem Auto gelangen können, und ein `Display` Punkt kann ein Punkt sein, der die Mitte des Parks angibt.

GeocodingResponse

Objekt

Dieses Objekt wird von einem erfolgreichen Geocodierungsaufruf zurückgegeben.

Name	Typ	Beschreibung
features	FeaturesItem[]	Eine Vielzahl von Funktionen wurde aus der Anfrage zurückgegeben.
nextLink	string	Dies ist der Link zur nächsten Seite der zurückgegebenen Features. Wenn es sich um die letzte Seite handelt, ist dieses Feld nicht vorhanden.
type	FeatureCollectionEnum	Gibt den `GeoJSON` Typ an. Der einzige unterstützte Objekttyp ist `FeatureCollection`. Weitere Informationen finden Sie unter RFC 7946.

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

GeoJsonPoint

Objekt

Ein gültiger GeoJSON Point Geometrietyp. Weitere Informationen finden Sie unter RFC 7946-.

Name	Typ	Beschreibung
bbox	number[] (double)	Begrenzungsrahmen. Projektion verwendet - EPSG:3857. Weitere Informationen finden Sie unter RFC 7946-.
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 `GeoJSON` Typ an. Muss einer der neun gültigen GeoJSON-Objekttypen sein : Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature und FeatureCollection.

Intersection

Objekt

Die Adresse des Ergebnisses.

Name	Typ	Beschreibung
baseStreet	string	Primäre Straße für den Standort.
displayName	string	Vollständiger Name der Schnittmenge.
intersectionType	string	Schnittmengetyp.
secondaryStreet1	string	Die erste überschneidende Straße.
secondaryStreet2	string	Wenn vorhanden, die zweite überschneidende Straße.

MatchCodesEnum

Enumeration

Ein Enum, das den Match-Code repräsentiert.

Wert	Beschreibung
Good	Gut
Ambiguous	Nicht eindeutig
UpHierarchy	UpHierarchy

ReverseGeocodingResultTypeEnum

Enumeration

Ein Enum, das den Ergebnistyp der umgekehrten Geokodierung darstellt.

Wert	Beschreibung
Address	Adresse
Neighborhood	Nachbarschaft
PopulatedPlace	Aufgefüllter Platz
Postcode1	Postleitzahl1
AdminDivision1	AdminDivision1
AdminDivision2	AdminDivision2
CountryRegion	Land/Region

UsageTypeEnum

Enumeration

Ein Enum, das den Nutzungstyp darstellt.

Wert	Beschreibung
Display	Anzeige
Route	Route

Freigeben über

Search - Get Reverse Geocoding

URI-Parameter

Anforderungsheader

Antworten

Sicherheit

AadToken

Bereiche

subscription-key

SAS Token

Beispiele

Search point -122.138681, 47.630358

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Address

AddressAdminDistrictsItem

AddressCountryRegion

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

CalculationMethodEnum

ConfidenceEnum

FeatureCollectionEnum

FeaturesItem

FeaturesItemProperties

FeatureTypeEnum

GeocodePointsItem

GeocodingResponse

GeoJsonObjectType

GeoJsonPoint

Intersection

MatchCodesEnum

ReverseGeocodingResultTypeEnum

UsageTypeEnum