Search - Get Reverse Geocoding

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 https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&coordinates={coordinates}

GET https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}

URI-Parameter

Anforderungsheader

Antworten

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.

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

Bereiche

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

Search point -122.138681, 47.630358

GET https://atlas.microsoft.com/reverseGeocode?api-version=2025-01-01&coordinates=-122.138681,47.630358

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

Address

Die Adresse des Ergebnisses

AdminDistricts

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.

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.

CountryRegion

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

FeatureCollectionEnum

Der Typ eines FeatureCollection-Objekts muss FeatureCollection sein.

FeaturesItem

FeatureTypeEnum

Der Typ eines Features muss feature sein.

GeocodePoints

Eine Sammlung von Geocodepunkten, die sich bei der Berechnung und deren vorgeschlagene Verwendung unterscheiden.

GeocodingResponse

Dieses Objekt wird von einem erfolgreichen Geocodierungsaufruf zurückgegeben.

GeoJsonPoint

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

Intersection

Die Adresse des Ergebnisses.

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.

Properties

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.

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.