Freigeben über


Search - Get Search Fuzzy

Verwenden Sie, wenn Sie eine Suchanforderung benötigen, die Kombinationen von Adressen und POI-Token verarbeiten kann.

Die Get Search Fuzzy (Freiform-Search)-API, eine HTTP-AnforderungGET, die eine Kombination aus POI-Suche und Geocodierung nahtlos verarbeitet. Es handelt sich um eine Freiform-Search-API, die Fuzzy von Eingaben mit einer beliebigen Kombination von Adress- oder POI-Token als kanonische "Einzeilensuche" behandelt. Es kann auch mit einer kontextbezogenen Position (lat/lon-Paar) gewichtet oder vollständig durch eine Koordinate und einen Radius eingeschränkt werden, oder es kann allgemeiner ohne geo biasing Ankerpunkt ausgeführt werden.

Wir empfehlen Ihnen dringend, den Parameter "countrySet" zu verwenden, um nur die Länder/Regionen anzugeben, für die Ihre Anwendung abgedeckt werden muss, da das Standardverhalten das Durchsuchen der gesamten Welt ist und möglicherweise unnötige Ergebnisse zurückgibt.

Beispiel: countrySet=US,FR

Eine vollständige Liste aller unterstützten Länder/Regionen finden Sie unter Search Coverage.

Die meisten Search Abfragen standardmäßig =2, maxFuzzyLevelum die Leistung zu steigern und ungewöhnliche Ergebnisse zu reduzieren. Dieser neue Standardwert kann bei Bedarf pro Anforderung überschrieben werden, indem der Abfrageparam maxFuzzyLevel=3 oder 4 übergeben wird.

GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/search/fuzzy/{format}?api-version=1.0&query={query}&typeahead={typeahead}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&lat={lat}&lon={lon}&radius={radius}&topLeft={topLeft}&btmRight={btmRight}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&minFuzzyLevel={minFuzzyLevel}&maxFuzzyLevel={maxFuzzyLevel}&idxSet={idxSet}&brandSet={brandSet}&connectorSet={connectorSet}&entityType={entityType}&view={view}&openingHours=nextSevenDays

URI-Parameter

Name In Erforderlich Typ Beschreibung
format
path True

ResponseFormat

Das gewünschte Format der Antwort. Der Wert kann entweder json oder xml sein.

api-version
query True

string

Versionsnummer der Azure Maps API.

query
query True

string

Die anwendbare Abfragezeichenfolge (z. B. "seattle", "pizza"). Kann auch als durch Trennzeichen getrennte Zeichenfolge angegeben werden, die nach Breitengrad gefolgt von Längengrad (z. B. "47.641268, -122.125679") zusammengesetzt ist. Muss ordnungsgemäß URL-codiert sein.

brandSet
query

string[]

Eine durch Trennzeichen getrennte Liste von Markennamen, die verwendet werden könnten, um das Ergebnis auf bestimmte Marken zu beschränken. Die Reihenfolge der Elemente ist unerheblich. Wenn mehrere Marken bereitgestellt werden, werden nur Ergebnisse zurückgegeben, die (mindestens) zu einer der bereitgestellten Liste gehören. Marken, die ein "," in ihrem Namen enthalten, sollten in Anführungszeichen gesetzt werden.

Anwendungsbeispiele:

brandSet=Foo

brandSet=Foo,Bar

brandSet="A,B,C-Komma",Balken

btmRight
query

string

Rechts unten des Begrenzungsrahmens. Z.B. 37.553,-122.453

categorySet
query

integer[]

Eine durch Trennzeichen getrennte Liste von Kategoriegruppen-IDs, die verwendet werden können, um das Ergebnis auf bestimmte Points of Interest-Kategorien zu beschränken. Die ID-Reihenfolge spielt keine Rolle. Die maximale Anzahl von Werten, die categorySet pro Anforderung unterstützt werden, ist 10. Wenn mehrere Kategoriebezeichner bereitgestellt werden, werden nur POIs zurückgegeben, die (mindestens) zu einer der Kategorien aus der angegebenen Liste gehören. Die Liste der unterstützten Kategorien kann mithilfe der POI-Kategorien-API ermittelt werden. Anwendungsbeispiele:

  • categorySet=7315 (Search Points of Interest aus der Kategorie Restaurant)

  • categorySet=7315025,7315017 (Search Points of Interest der Kategorie entweder italienisches oder französisches Restaurant)

connectorSet
query

ElectricVehicleConnector[]

Eine durch Trennzeichen getrennte Liste von Verbindungstypen, die verwendet werden könnten, um das Ergebnis auf die Elektrische Fahrzeugstation zu beschränken, die bestimmte Steckertypen unterstützt. Die Reihenfolge der Elemente ist unerheblich. Wenn mehrere Connectortypen bereitgestellt werden, werden nur Ergebnisse zurückgegeben, die (mindestens) zu einer der bereitgestellten Liste gehören.

Verfügbare Connectortypen sind:

  • StandardHouseholdCountrySpecific - Dies sind die Standard-Haushaltsconnectors für eine bestimmte Region. Sie sind alle einphasig AC und die Standardspannung und Standard-Amperage. Siehe auch: Steckdosentypen & – Weltstandards.
  • IEC62196Type1 - Stecker vom Typ 1 gemäß iec 62196-2 Auch Yazaki nach dem ursprünglichen Hersteller oder SAE J1772 nach dem Standard genannt, der es zuerst veröffentlicht hat. Wird meist in Kombination mit 120V einphasigen oder bis zu 240 V Einphaseninfrastruktur verwendet.
  • IEC62196Type1CCS - Typ 1-basierter Kombinationsstecker, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-1-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC), um das DC-Schnellladen zu ermöglichen.
  • IEC62196Type2CableAttached - Stecker vom Typ 2 gemäß der Norm IEC 62196-2. Wird als Kabel und Stecker an der Ladesäule bereitgestellt.
  • IEC62196Type2Outlet - Stecker vom Typ 2 gemäß der Norm IEC 62196-2. Wird als Steckdose im Ladepunkt bereitgestellt.
  • IEC62196Type2CCS - Typ 2-basierte Kombinationssteckverbinder, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-2-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC) zum Dc-Schnellladen.
  • IEC62196Type3 - Stecker vom Typ 3 gemäß der Norm IEC 62196-2. Auch Scame nach dem ursprünglichen Hersteller genannt. Meist in Kombination mit bis zu 240 V einphasigen oder bis zu 420 V Dreiphaseninfrastruktur.
  • Chademo - CHAdeMO-Connector benannt nach einer Vereinigung, die von der Tokyo Electric Power Company und Industriepartnern gegründet wurde. Aus diesem Grund wird auch als TEPCO-Connector bezeichnet. Es unterstützt schnelles DC-Aufladen.
  • IEC60309AC1PhaseBlue - Industrial Blue Connector ist ein in der IEC 60309-Norm definierter Stecker. Es wird irgendwann als eine Kombination aus dem Standard, der Farbe und der Tatsache bezeichnet, dass es sich um einen Einphasenconnector handelt. Der Connector verfügt in der Regel über die Konfiguration "P+N+E, 6h".
  • IEC60309DCWhite - Industrial White Connector ist ein gleichgestellter Stecker, der in der IEC 60309-Norm definiert ist.
  • Tesla - Der Tesla-Stecker ist der regional spezifische Tesla Supercharger-Connector. D.h. es bezieht sich entweder auf den proprietären Connector von Tesla, der manchmal als Tesla Port bezeichnet wird, der meist auf Nordamerika beschränkt ist, oder auf den modifizierten Typ 2 (DC über Typ 2) in Europa.

Anwendungsbeispiele:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached

countrySet
query

string[]

Durch Trennzeichen getrennte Zeichenfolge von Länder-/Regionscodes, z. B. FR, ES. Dadurch wird die Suche auf die angegebenen Länder/Regionen beschränkt.

entityType
query

GeographicEntityType

Gibt die Ebene der Filterung an, die für Geografische Regionen ausgeführt wird. Schränkt die Suche nach angegebenen geografischen Entitätstypen ein, z. B. nur Gemeinde zurückgeben. Die resultierende Antwort enthält die Geografie-ID sowie den passenden Entitätstyp. Wenn Sie mehrere Entitäten als kommagetrennte Liste angeben, gibt der Endpunkt die "kleinste verfügbare Entität" zurück. Die zurückgegebene Geometrie-ID kann verwendet werden, um die Geometrie dieser Geografie über die Get Search Polygon-API abzurufen. Die folgenden Parameter werden ignoriert, wenn entityType festgelegt wird:

  • Überschrift
  • number
  • returnRoadUse
  • returnSpeedLimit
  • roadUse
  • returnMatchType
extendedPostalCodesFor
query

SearchIndexes[]

Indizes, für die erweiterte Postleitzahlen in die Ergebnisse aufgenommen werden sollen.

Verfügbare Indizes sind:

Addr = Adressbereiche

Geo = Geografien

PAD = Punktadressen

POI = Points of Interest

Str = Straßen

XStr = Cross Street (Kreuzungen)

Der Wert sollte eine durch Trennzeichen getrennte Liste von Indextypen (in beliebiger Reihenfolge) oder Keine für keine Indizes sein.

Standardmäßig sind erweiterte Postleitzahlen für alle Indizes mit Ausnahme von Geo enthalten. Erweiterte Postleitzahlenlisten für geografische Regionen können recht lang sein, sodass sie bei Bedarf explizit angefordert werden müssen.

Anwendungsbeispiele:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Erweiterte Postleitzahl wird als extendedPostalCode-Eigenschaft einer Adresse zurückgegeben. Die Verfügbarkeit ist regionsabhängig.

idxSet
query

SearchIndexes[]

Eine durch Kommage getrennte Liste von Indizes, die für die Suche verwendet werden sollen. Die Reihenfolge der Elemente ist unerheblich. Verfügbare Indizes sind: Addr = Adressbereich interpolation, Geo = Geographies, PAD = Punktadressen, POI = Points of Interest, Str = Streets, Xstr = Cross Streets (Kreuzungen)

language
query

string

Sprache, in der Suchergebnisse zurückgegeben werden sollen. Sollte eines der unterstützten IETF-Sprachtags sein, wobei die Groß-/Kleinschreibung nicht beachtet wird. Wenn Daten in der angegebenen Sprache für ein bestimmtes Feld nicht verfügbar sind, wird die Standardsprache verwendet.

Weitere Informationen finden Sie unter Unterstützte Sprachen .

lat
query

number

double

Breitengrad, in dem die Ergebnisse verzerrt sein sollen. Beispiel: 37.337

limit
query

integer

Maximale Anzahl von Antworten, die zurückgegeben werden. Standard: 10, Minimum: 1 und Maximum: 100

lon
query

number

double

Längengrad, bei dem die Ergebnisse verzerrt sein sollen. Beispiel: -121,89

maxFuzzyLevel
query

integer

Maximale Fuzziness-Ebene, die verwendet werden soll. Standard: 2, Minimum: 1 und Maximum: 4

  • Ebene 1 verfügt über keine Rechtschreibprüfung.

  • Stufe 2 verwendet die normale n-Gramm-Rechtschreibprüfung. Beispielsweise kann die Abfrage "restrant" mit "restaurant" abgeglichen werden.

  • Stufe 3 verwendet die rechtschreibähnliche Rechtschreibprüfung und die Schindelschreibprüfung. Die laute Rechtschreibprüfung gilt für den Abgleich von "rstrnt" zu "restaurant". Die Shingle-Rechtschreibprüfung ist für die Übereinstimmung zwischen "Mountainview" und "Mountain View".

  • Stufe 4 fügt keine weiteren Rechtschreibprüfungsfunktionen hinzu.

Die Suchmaschine sucht nach einer Übereinstimmung auf der von minFuzzyLevel definierten Ebene und beendet die Suche auf der von maxFuzzyLevel angegebenen Ebene.

minFuzzyLevel
query

integer

Minimale zu verwendende Fuzziness-Stufe. Standard: 1, Minimum: 1 und Maximum: 4

  • Ebene 1 verfügt über keine Rechtschreibprüfung.

  • Stufe 2 verwendet die normale n-Gramm-Rechtschreibprüfung. Beispielsweise kann die Abfrage "restrant" mit "restaurant" abgeglichen werden.

  • Stufe 3 verwendet die rechtschreibähnliche Rechtschreibprüfung und die Schindelschreibprüfung. Die laute Rechtschreibprüfung gilt für den Abgleich von "rstrnt" zu "restaurant". Die Shingle-Rechtschreibprüfung ist für die Übereinstimmung zwischen "Mountainview" und "Mountain View".

  • Stufe 4 fügt keine weiteren Rechtschreibprüfungsfunktionen hinzu.

Die Suchmaschine sucht nach einer Übereinstimmung auf der durch minFuzzyLevel definierten Ebene und beendet die Suche auf der durch maxFuzzyLevel angegebenen Ebene.

ofs
query

integer

Startoffset der zurückgegebenen Ergebnisse innerhalb des vollständigen Resultsets. Standardwert: 0

openingHours
query

OperatingHoursRange

Betriebsstunden für einen POI (Points of Interest). Die Verfügbarkeit der Betriebsstunden hängt von den verfügbaren Daten ab. Wenn nicht bestanden, werden keine Öffnungszeiteninformationen zurückgegeben. Unterstützter Wert: nextSevenDays

radius
query

integer

Der Radius in Metern bis, damit die Ergebnisse auf den definierten Bereich beschränkt werden.

topLeft
query

string

Obere linke Position des Begrenzungsrahmens. Z.B. 37.553,-122.453

typeahead
query

boolean

Boolesch. Wenn das Flag typeahead festgelegt ist, wird die Abfrage als teilbare Eingabe interpretiert, und die Suche wechselt in den Vorhersagemodus.

view
query

LocalizedMapView

Mit dem Parameter View (auch als "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitisch umstrittene Regionen anzeigen. Verschiedene Länder/Regionen haben unterschiedliche Ansichten zu diesen Regionen, und der View-Parameter ermöglicht es Ihrer Anwendung, die Ansicht zu erfüllen, die für das Land/die Region erforderlich ist, in dem/der Ihre Anwendung verwendet wird. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn nicht in der Anforderung definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der View-Parameter in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen zur Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten sowie Inhalte von Drittanbietern, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN.

Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten .

Anforderungsheader

Name Erforderlich Typ Beschreibung
x-ms-client-id

string

Gibt an, welches Konto in Verbindung mit dem Microsoft Entra ID-Sicherheitsmodell verwendet werden soll. Es stellt eine eindeutige ID für das Azure Maps-Konto dar und kann von der Azure Maps-Verwaltungsebenen-API abgerufen werden. Informationen zur Verwendung Microsoft Entra ID Sicherheit in Azure Maps finden Sie in den folgenden Artikeln.

Antworten

Name Typ Beschreibung
200 OK

SearchAddressResult

OK

Other Status Codes

ErrorResponse

Ein unerwarteter Fehler ist aufgetreten.

Sicherheit

AADToken

Dies sind die Microsoft Entra OAuth 2.0-Flows. In Kombination mit der rollenbasierten Zugriffssteuerung in Azure kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Rollenbasierte Zugriffssteuerungen in Azure werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps Ressourcenkonto oder Unterressourcen festzulegen. Jedem Benutzer, jeder Gruppe oder einem Dienstprinzipal kann zugriff über eine integrierte Rolle oder eine benutzerdefinierte Rolle gewährt werden, die aus einer oder mehreren Berechtigungen für Azure Maps REST-APIs besteht.

Zur Implementierung von Szenarien wird empfohlen, Authentifizierungskonzepte anzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung zum Modellieren von Anwendungen über Objekte, die die Zugriffssteuerung für bestimmte APIs und Bereiche ermöglichen.

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 Kartenverwaltungs-API abgerufen werden.
  • ist Authorization URL spezifisch für die öffentliche Azure-Cloud instance. Sovereign Clouds verfügen über eindeutige Autorisierungs-URLs und Microsoft Entra ID Konfigurationen.
  • Die rollenbasierte Zugriffssteuerung in Azure wird über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs konfiguriert.
  • Die Verwendung des Azure Maps Web SDK ermöglicht die konfigurationsbasierte Einrichtung einer Anwendung für mehrere Anwendungsfälle.
  • Weitere Informationen zu Microsoft Identity Platform finden Sie unter 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 https://atlas.microsoft.com/.default

subscription-key

Dies ist ein gemeinsam verwendeter Schlüssel, der beim Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API bereitgestellt wird.

Mit diesem Schlüssel kann jede Anwendung auf die gesamte REST-API zugreifen. Anders ausgedrückt: Dieser Schlüssel kann als master Schlüssel in dem Konto verwendet werden, in dem er ausgestellt wird.

Für öffentlich zugängliche Anwendungen wird empfohlen, den Ansatz vertraulicher Clientanwendungen für den Zugriff auf Azure Maps REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: query

SAS Token

Dies ist ein Shared Access Signature-Token, das aus dem Sas-Listenvorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt wird.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und einer präzisen Steuerung des Ablaufs, der Rate und der Regionen für das jeweilige Token autorisiert. Anders ausgedrückt: Das SAS-Token kann verwendet werden, um Anwendungen die Steuerung des Zugriffs auf eine sicherere Weise zu ermöglichen als der gemeinsam genutzte Schlüssel.

Für öffentlich verfügbar gemachte Anwendungen wird empfohlen, eine bestimmte Liste der zulässigen Ursprünge in der Ressource "Konto zuordnen " zu konfigurieren, um den Renderingmissbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Search City Seattle

Beispielanforderung

GET https://atlas.microsoft.com/search/fuzzy/json?api-version=1.0&query=seattle&openingHours=nextSevenDays

Beispiel für eine Antwort

{
  "summary": {
    "query": "seattle",
    "queryType": "NON_NEAR",
    "queryTime": 66,
    "numResults": 10,
    "offset": 0,
    "totalResults": 3720,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "Geography",
      "id": "US/GEO/p0/188055",
      "score": 2.531,
      "entityType": "Municipality",
      "address": {
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "Seattle, WA",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.60323,
        "lon": -122.33028
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.7344,
          "lon": -122.4594
        },
        "btmRightPoint": {
          "lat": 47.48106,
          "lon": -122.22497
        }
      },
      "dataSources": {
        "geometry": {
          "id": "00005557-4100-3c00-0000-0000596ae8ed"
        }
      }
    },
    {
      "type": "Geography",
      "id": "US/GEO/p0/183911",
      "score": 2.382,
      "entityType": "Municipality",
      "address": {
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countrySubdivisionCode": "WA",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "Seattle, WA",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.55342,
        "lon": -122.25007
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.58995,
          "lon": -122.26723
        },
        "btmRightPoint": {
          "lat": 47.5169,
          "lon": -122.23291
        }
      },
      "dataSources": {
        "geometry": {
          "id": "00005557-4100-3c00-0000-00006553f33d"
        }
      }
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/449288",
      "score": 2.226,
      "info": "search:ta:710009004165863-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Groote Kerk Sentrum",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "streetName": "Kloof Street",
        "municipalitySubdivision": "Cape Town",
        "municipality": "Cape Town",
        "countrySecondarySubdivision": "City of Cape Town",
        "countrySubdivisionCode": "Western Cape",
        "postalCode": "8001",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Kloof Street, Gardens, City of Cape Town, Western Cape, 8001",
        "localName": "Gardens"
      },
      "position": {
        "lat": -33.92917,
        "lon": 18.41178
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -33.92827,
          "lon": 18.4107
        },
        "btmRightPoint": {
          "lat": -33.93007,
          "lon": 18.41286
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -33.92907,
            "lon": 18.41162
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/449396",
      "score": 2.226,
      "info": "search:ta:710009004163591-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Pietermaritzburg",
        "phone": "+(27)-(33)-3458486",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "9",
        "streetName": "Armitage Road",
        "municipalitySubdivision": "Pietermaritzburg City, Pietermaritzburg",
        "municipality": "Pietermaritzburg",
        "countrySecondarySubdivision": "The Msunduzi",
        "countrySubdivisionCode": "KwaZulu-Natal",
        "postalCode": "3201",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Armitage Road 9, Athlone, The Msunduzi, KwaZulu-Natal, 3201",
        "localName": "Athlone"
      },
      "position": {
        "lat": -29.58611,
        "lon": 30.37508
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -29.58521,
          "lon": 30.37405
        },
        "btmRightPoint": {
          "lat": -29.58701,
          "lon": 30.37611
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -29.58668,
            "lon": 30.37531
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/451868",
      "score": 2.226,
      "info": "search:ta:710009002195538-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Bedford Village",
        "phone": "+(27)-(84)-5451111",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "streetName": "Van Buuren Road",
        "municipalitySubdivision": "Bedfordview",
        "municipality": "Germiston",
        "countrySecondarySubdivision": "Ekurhuleni",
        "countrySubdivisionCode": "Gauteng",
        "postalCode": "2007",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Van Buuren Road, Bedfordview, Ekurhuleni, Gauteng, 2007",
        "localName": "Bedfordview"
      },
      "position": {
        "lat": -26.18009,
        "lon": 28.13544
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -26.17919,
          "lon": 28.13444
        },
        "btmRightPoint": {
          "lat": -26.18099,
          "lon": 28.13644
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -26.18006,
            "lon": 28.13636
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/488888",
      "score": 2.226,
      "info": "search:ta:710009002102639-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Caltex Starstop Milly's",
        "phone": "+(27)-(13)-2560340",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "municipality": "Wonderfontein",
        "countrySecondarySubdivision": "Emakhazeni",
        "countrySubdivisionCode": "Mpumalanga",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Wonderfontein, Emakhazeni, Mpumalanga"
      },
      "position": {
        "lat": -25.68842,
        "lon": 30.21291
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -25.68752,
          "lon": 30.21191
        },
        "btmRightPoint": {
          "lat": -25.68932,
          "lon": 30.21391
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -25.68913,
            "lon": 30.21343
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/489433",
      "score": 2.226,
      "info": "search:ta:710009002184068-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Southcoast Mall",
        "phone": "+(27)-(39)-3150816",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "municipalitySubdivision": "Shelly Beach",
        "municipality": "Shelly Beach",
        "countrySecondarySubdivision": "Hibiscus Coast",
        "countrySubdivisionCode": "KwaZulu-Natal",
        "postalCode": "4265",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
        "localName": "Shelly Beach"
      },
      "position": {
        "lat": -30.79937,
        "lon": 30.40569
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -30.79847,
          "lon": 30.40464
        },
        "btmRightPoint": {
          "lat": -30.80027,
          "lon": 30.40674
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -30.7994,
            "lon": 30.40618
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/489976",
      "score": 2.226,
      "info": "search:ta:710009004261897-ZA",
      "poi": {
        "name": "Seattle Cofee Co",
        "phone": "+(27)-(39)-3150816",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "municipalitySubdivision": "Shelly Beach",
        "municipality": "Shelly Beach",
        "countrySecondarySubdivision": "Hibiscus Coast",
        "countrySubdivisionCode": "KwaZulu-Natal",
        "postalCode": "4265",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Shelly Beach, Hibiscus Coast, KwaZulu-Natal, 4265",
        "localName": "Shelly Beach"
      },
      "position": {
        "lat": -30.79801,
        "lon": 30.40557
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -30.79711,
          "lon": 30.40452
        },
        "btmRightPoint": {
          "lat": -30.79891,
          "lon": 30.40662
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -30.79784,
            "lon": 30.40523
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/490056",
      "score": 2.226,
      "info": "search:ta:710009004149612-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Constantia Village",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "streetName": "Constantia Main Road",
        "municipalitySubdivision": "Cape Town",
        "municipality": "Cape Town",
        "countrySecondarySubdivision": "City of Cape Town",
        "countrySubdivisionCode": "Western Cape",
        "postalCode": "7708",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Constantia Main Road, Constantia, City of Cape Town, Western Cape, 7708",
        "localName": "Constantia"
      },
      "position": {
        "lat": -34.02087,
        "lon": 18.44503
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -34.01997,
          "lon": 18.44394
        },
        "btmRightPoint": {
          "lat": -34.02177,
          "lon": 18.44612
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -34.02017,
            "lon": 18.44476
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "ZA/POI/p0/494340",
      "score": 2.226,
      "info": "search:ta:710009004152570-ZA",
      "poi": {
        "name": "Seattle Coffee Co - Canal Walk Shopping Centre",
        "brands": [
          {
            "name": "Seattle Coffee Company"
          }
        ],
        "categorySet": [
          {
            "id": 9376006
          }
        ],
        "url": "www.seattlecoffeecompany.co.za",
        "classifications": [
          {
            "code": "CAFE_PUB",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "coffee shop"
              },
              {
                "nameLocale": "en-US",
                "name": "café/pub"
              }
            ]
          }
        ]
      },
      "address": {
        "streetName": "Century Boulevard",
        "municipalitySubdivision": "Milnerton",
        "municipality": "Cape Town",
        "countrySecondarySubdivision": "City of Cape Town",
        "countrySubdivisionCode": "Western Cape",
        "postalCode": "7441",
        "countryCode": "ZA",
        "country": "South Africa",
        "countryCodeISO3": "ZAF",
        "freeformAddress": "Century Boulevard, Century City, City of Cape Town, Western Cape, 7441",
        "localName": "Century City"
      },
      "position": {
        "lat": -33.89348,
        "lon": 18.5122
      },
      "viewport": {
        "topLeftPoint": {
          "lat": -33.89258,
          "lon": 18.51112
        },
        "btmRightPoint": {
          "lat": -33.89438,
          "lon": 18.51328
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": -33.8943,
            "lon": 18.51328
          }
        }
      ]
    }
  ]
}

Definitionen

Name Beschreibung
Address

Die Adresse des Ergebnisses

AddressRanges

Beschreibt den Adressbereich auf beiden Straßenseiten für ein Suchergebnis. Koordinaten für die Anfangs- und Endpositionen des Adressbereichs sind enthalten.

BoundingBox

Der Viewport, der das Ergebnis abdeckt, das durch die koordinaten oben links und unten rechts des Viewports dargestellt wird.

BoundingBoxCompassNotation

Das begrenzungsfeld der Position.

Brand

Die Marke, die dem POI zugeordnet ist

Classification

Die Klassifizierung für den zurückgegebenen POI

ClassificationName

Name für die Klassifizierung

DataSources

Optionaler Abschnitt Referenz-IDs für die Verwendung mit der Get Search Polygon-API.

ElectricVehicleConnector

Eine durch Trennzeichen getrennte Liste von Verbindungstypen, die verwendet werden könnten, um das Ergebnis auf die Elektrische Fahrzeugstation zu beschränken, die bestimmte Steckertypen unterstützt. Die Reihenfolge der Elemente ist unerheblich. Wenn mehrere Connectortypen bereitgestellt werden, werden nur Ergebnisse zurückgegeben, die (mindestens) zu einer der bereitgestellten Liste gehören.

Verfügbare Connectortypen sind:

  • StandardHouseholdCountrySpecific - Dies sind die Standard-Haushaltsconnectors für eine bestimmte Region. Sie sind alle einphasig AC und die Standardspannung und Standard-Amperage. Siehe auch: Steckdosentypen & – Weltstandards.
  • IEC62196Type1 - Stecker vom Typ 1 gemäß iec 62196-2 Auch Yazaki nach dem ursprünglichen Hersteller oder SAE J1772 nach dem Standard genannt, der es zuerst veröffentlicht hat. Wird meist in Kombination mit 120V einphasigen oder bis zu 240 V Einphaseninfrastruktur verwendet.
  • IEC62196Type1CCS - Typ 1-basierter Kombinationsstecker, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-1-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC), um das DC-Schnellladen zu ermöglichen.
  • IEC62196Type2CableAttached - Stecker vom Typ 2 gemäß der Norm IEC 62196-2. Wird als Kabel und Stecker an der Ladesäule bereitgestellt.
  • IEC62196Type2Outlet - Stecker vom Typ 2 gemäß der Norm IEC 62196-2. Wird als Steckdose im Ladepunkt bereitgestellt.
  • IEC62196Type2CCS - Typ 2-basierte Kombinationssteckverbinder, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-2-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC) zum Dc-Schnellladen.
  • IEC62196Type3 - Stecker vom Typ 3 gemäß der Norm IEC 62196-2. Auch Scame nach dem ursprünglichen Hersteller genannt. Meist in Kombination mit bis zu 240 V einphasigen oder bis zu 420 V Dreiphaseninfrastruktur.
  • Chademo - CHAdeMO-Connector benannt nach einer Vereinigung, die von der Tokyo Electric Power Company und Industriepartnern gegründet wurde. Aus diesem Grund wird auch als TEPCO-Connector bezeichnet. Es unterstützt schnelles DC-Aufladen.
  • IEC60309AC1PhaseBlue - Industrial Blue Connector ist ein in der IEC 60309-Norm definierter Stecker. Es wird irgendwann als eine Kombination aus dem Standard, der Farbe und der Tatsache bezeichnet, dass es sich um einen Einphasenconnector handelt. Der Connector verfügt in der Regel über die Konfiguration "P+N+E, 6h".
  • IEC60309DCWhite - Industrial White Connector ist ein gleichgestellter Stecker, der in der IEC 60309-Norm definiert ist.
  • Tesla - Der Tesla-Stecker ist der regional spezifische Tesla Supercharger-Connector. D.h. es bezieht sich entweder auf den proprietären Connector von Tesla, der manchmal als Tesla Port bezeichnet wird, der meist auf Nordamerika beschränkt ist, oder auf den modifizierten Typ 2 (DC über Typ 2) in Europa.

Anwendungsbeispiele:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached

Entity

Entitätstypquelle des Begrenzungsrahmens. Bei umgekehrter Geocodierung ist dies immer gleich der Position.

EntryPoint

Der Einstiegspunkt für den zurückgegebenen POI.

EntryPointType

Der Typ des Einstiegspunkts. Der Wert kann entweder Standard oder Nebenwert sein.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

GeographicEntityType

Geography-Entitätstyp. Nur vorhanden, wenn entityType angefordert wurde und verfügbar ist.

Geometry

Informationen über die geometrische Form des Ergebnisses. Nur vorhanden, wenn typ == Geography.

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

LocalizedMapView

Mit dem Parameter View (auch als "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitisch umstrittene Regionen anzeigen. Verschiedene Länder/Regionen haben unterschiedliche Ansichten zu diesen Regionen, und der View-Parameter ermöglicht es Ihrer Anwendung, die Ansicht zu erfüllen, die für das Land/die Region erforderlich ist, in dem/der Ihre Anwendung verwendet wird. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn nicht in der Anforderung definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der View-Parameter in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen zur Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten sowie Inhalte von Drittanbietern, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN.

Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten .

MatchType

Übereinstimmungstypen für einen Suchvorgang für umgekehrte Adressen.

OperatingHours

Öffnungszeiten für einen POI (Points of Interest).

OperatingHoursRange

Betriebsstunden für einen POI (Points of Interest). Die Verfügbarkeit der Betriebsstunden variiert je nach verfügbaren Daten. Wenn sie nicht bestanden wird, werden keine Öffnungszeiteninformationen zurückgegeben. Unterstützter Wert: nextSevenDays

OperatingHoursTime

Stellt ein Datum und eine Uhrzeit dar.

OperatingHoursTimeRange

Geöffneter Zeitbereich für einen Tag

PointOfInterest

Details des zurückgegebenen POI, einschließlich Informationen wie Name, Telefon, URL-Adresse und Klassifizierungen.

PointOfInterestCategorySet

POI-Kategorie

QueryType

Der Typ der zurückgegebenen Abfrage: NEARBY oder NON_NEAR.

ResponseFormat

Gewünschtes Format der Antwort. Der Wert kann entweder json oder xml sein.

SearchAddressResult

Dieses Objekt wird von erfolgreichen Search-Aufrufen zurückgegeben.

SearchAddressResultItem

Ergebnisobjekt für eine Search API-Antwort.

SearchAddressResultType

Enthält einen der folgenden Werte:

  • POI
  • Straße
  • Gebiet
  • Punktadresse
  • Adressbereich
  • Querstraße
SearchIndexes

Indizes, für die erweiterte Postleitzahlen in die Ergebnisse aufgenommen werden sollten.

Verfügbare Indizes sind:

Addr = Adressbereiche

Geo = Geographie

PAD = Punktadressen

POI = Points of Interest

Str = Straßen

XStr = Cross Street (Kreuzungen)

Der Wert sollte eine durch Kommage getrennte Liste von Indextypen (in beliebiger Reihenfolge) oder Keine für keine Indizes sein.

Standardmäßig sind erweiterte Postleitzahlen für alle Indizes mit Ausnahme von Geo enthalten. Erweiterte Postleitzahlenlisten für Geografische Regionen können recht lang sein, sodass sie bei Bedarf explizit angefordert werden müssen.

Anwendungsbeispiele:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Erweiterte Postleitzahl wird als extendedPostalCode-Eigenschaft einer Adresse zurückgegeben. Die Verfügbarkeit ist regionsabhängig.

SearchSummary

Zusammenfassungsobjekt für eine Search-API-Antwort.

Address

Die Adresse des Ergebnisses

Name Typ Beschreibung
boundingBox

BoundingBoxCompassNotation

Das begrenzungsfeld der Position.

buildingNumber

string

Die Gebäudenummer auf der Straße. VERALTET, verwenden Sie stattdessen streetNumber.

country

string

Name des Landes/der Region

countryCode

string

Land (Hinweis: Dies ist ein code aus zwei Buchstaben, kein Name des Landes/der Region.)

countryCodeISO3

string

ISO-Alpha-3-Ländercode

countrySecondarySubdivision

string

County

countrySubdivision

string

Bundesland oder Kanton

countrySubdivisionCode

string

countrySubdivisionCode präfixiert durch countryCode ( countryCode-countrySubdivisionCode ) und der Bindestrich bildet den ISO 3166-2-Code. Beispiele: TX für Texas, SCT für Schottland und ON für Ontario.

countrySubdivisionName

string

Der vollständige Name einer ersten Ebene der Verwaltungshierarchie für Land/Region. Dieses Feld wird nur angezeigt, wenn countrySubdivision in einer gekürzten Form dargestellt wird. Wird nur für die USA, Kanada und Das Vereinigte Königreich unterstützt.

countryTertiarySubdivision

string

Benannter Bereich

crossStreet

string

Der Name der Straße, die gekreuzt wird.

extendedPostalCode

string

Erweiterte Postleitzahl (Verfügbarkeit hängt von der Region ab).

freeformAddress

string

Eine Adresszeile, die gemäß den Formatierungsregeln des Ursprungslandes/der Region eines Ergebnisses oder im Fall eines Landes/einer Region den vollständigen Namen des Landes/der Region formatiert ist.

localName

string

Eine Adresskomponente, die den Namen eines geografischen Bereichs oder Orts darstellt, der mehrere adressierbare Objekte zu Adressierungszwecken gruppiert, ohne eine Verwaltungseinheit zu sein. Dieses Feld wird verwendet, um die freeformAddress -Eigenschaft zu erstellen. localName stellt die Postgemeinde dar. Je nach Standort localName ist der allgemein bekannte Name einer Stadt oder Stadt. Verwenden Sie localName für den allgemein bekannten Namen einer Stadt oder Stadt anstelle von municipality.

municipality

string

Ort/ Ort
Hinweis: municipality stellt die Wohngemeinde dar. Je nach Standort kann sich der municipality Wert vom allgemein bekannten Namen einer Stadt oder Stadt unterscheiden. Für den allgemein bekannten Namen der Stadt wird empfohlen, den localName Wert anstelle des municipality Werts zu verwenden.

municipalitySubdivision

string

Sub/ Super City

neighbourhood

string

Ein Viertel ist ein geografisch lokalisiertes Gebiet innerhalb einer Stadt oder Stadt mit charakteristischen Merkmalen und sozialen Interaktionen zwischen den Bewohnern.

postalCode

string

Postleitzahl / Postleitzahl

routeNumbers

string[]

Die Codes, die verwendet werden, um die Straße eindeutig zu identifizieren

street

string

Der Straßenname. VERALTET, verwenden Sie stattdessen streetName.

streetName

string

Der Straßenname.

streetNameAndNumber

string

Der Straßenname und die Nummer.

streetNumber

string

Die Gebäudenummer auf der Straße.

AddressRanges

Beschreibt den Adressbereich auf beiden Straßenseiten für ein Suchergebnis. Koordinaten für die Anfangs- und Endpositionen des Adressbereichs sind enthalten.

Name Typ Beschreibung
from

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

rangeLeft

string

Adressbereich auf der linken Straßenseite.

rangeRight

string

Adressbereich auf der rechten Straßenseite.

to

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

BoundingBox

Der Viewport, der das Ergebnis abdeckt, das durch die koordinaten oben links und unten rechts des Viewports dargestellt wird.

Name Typ Beschreibung
btmRightPoint

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

topLeftPoint

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

BoundingBoxCompassNotation

Das begrenzungsfeld der Position.

Name Typ Beschreibung
entity

Entity

Entitätstypquelle des Begrenzungsrahmens. Bei umgekehrter Geocodierung ist dies immer gleich der Position.

northEast

string

Nord-Ost-Breitengrad, Längengradkoordinate des Begrenzungsrahmens als durch Trennzeichen getrennte Gleitkomma

southWest

string

Südwestlicher Breitengrad, Längengradkoordinate des Begrenzungsrahmens als durch Trennzeichen getrennte Gleitkomma

Brand

Die Marke, die dem POI zugeordnet ist

Name Typ Beschreibung
name

string

Name der Marke

Classification

Die Klassifizierung für den zurückgegebenen POI

Name Typ Beschreibung
code

string

Eigenschaft „code“

names

ClassificationName[]

Namensarray

ClassificationName

Name für die Klassifizierung

Name Typ Beschreibung
name

string

Name-Eigenschaft

nameLocale

string

Name Locale-Eigenschaft

DataSources

Optionaler Abschnitt Referenz-IDs für die Verwendung mit der Get Search Polygon-API.

Name Typ Beschreibung
geometry

Geometry

Informationen über die geometrische Form des Ergebnisses. Nur vorhanden, wenn typ == Geography.

ElectricVehicleConnector

Eine durch Trennzeichen getrennte Liste von Verbindungstypen, die verwendet werden könnten, um das Ergebnis auf die Elektrische Fahrzeugstation zu beschränken, die bestimmte Steckertypen unterstützt. Die Reihenfolge der Elemente ist unerheblich. Wenn mehrere Connectortypen bereitgestellt werden, werden nur Ergebnisse zurückgegeben, die (mindestens) zu einer der bereitgestellten Liste gehören.

Verfügbare Connectortypen sind:

  • StandardHouseholdCountrySpecific - Dies sind die Standard-Haushaltsconnectors für eine bestimmte Region. Sie sind alle einphasig AC und die Standardspannung und Standard-Amperage. Siehe auch: Steckdosentypen & – Weltstandards.
  • IEC62196Type1 - Stecker vom Typ 1 gemäß iec 62196-2 Auch Yazaki nach dem ursprünglichen Hersteller oder SAE J1772 nach dem Standard genannt, der es zuerst veröffentlicht hat. Wird meist in Kombination mit 120V einphasigen oder bis zu 240 V Einphaseninfrastruktur verwendet.
  • IEC62196Type1CCS - Typ 1-basierter Kombinationsstecker, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-1-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC), um das DC-Schnellladen zu ermöglichen.
  • IEC62196Type2CableAttached - Stecker vom Typ 2 gemäß der Norm IEC 62196-2. Wird als Kabel und Stecker an der Ladesäule bereitgestellt.
  • IEC62196Type2Outlet - Stecker vom Typ 2 gemäß der Norm IEC 62196-2. Wird als Steckdose im Ladepunkt bereitgestellt.
  • IEC62196Type2CCS - Typ 2-basierte Kombinationssteckverbinder, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-2-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC) zum Dc-Schnellladen.
  • IEC62196Type3 - Stecker vom Typ 3 gemäß der Norm IEC 62196-2. Auch Scame nach dem ursprünglichen Hersteller genannt. Meist in Kombination mit bis zu 240 V einphasigen oder bis zu 420 V Dreiphaseninfrastruktur.
  • Chademo - CHAdeMO-Connector benannt nach einer Vereinigung, die von der Tokyo Electric Power Company und Industriepartnern gegründet wurde. Aus diesem Grund wird auch als TEPCO-Connector bezeichnet. Es unterstützt schnelles DC-Aufladen.
  • IEC60309AC1PhaseBlue - Industrial Blue Connector ist ein in der IEC 60309-Norm definierter Stecker. Es wird irgendwann als eine Kombination aus dem Standard, der Farbe und der Tatsache bezeichnet, dass es sich um einen Einphasenconnector handelt. Der Connector verfügt in der Regel über die Konfiguration "P+N+E, 6h".
  • IEC60309DCWhite - Industrial White Connector ist ein gleichgestellter Stecker, der in der IEC 60309-Norm definiert ist.
  • Tesla - Der Tesla-Stecker ist der regional spezifische Tesla Supercharger-Connector. D.h. es bezieht sich entweder auf den proprietären Connector von Tesla, der manchmal als Tesla Port bezeichnet wird, der meist auf Nordamerika beschränkt ist, oder auf den modifizierten Typ 2 (DC über Typ 2) in Europa.

Anwendungsbeispiele:

connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached

Name Typ Beschreibung
Chademo

string

CHAdeMO Connector benannt nach einer Vereinigung, die von der Tokyo Electric Power Company und Industriepartnern gegründet wurde. Aus diesem Grund wird auch als TEPCO-Connector bezeichnet. Es unterstützt schnelles DC-Aufladen.

IEC60309AC1PhaseBlue

string

Industrial Blue-Stecker ist ein in der IEC 60309-Norm definierter Stecker. Es wird irgendwann als eine Kombination aus dem Standard, der Farbe und der Tatsache bezeichnet, dass es sich um einen Einphasenconnector handelt. Der Connector verfügt in der Regel über die Konfiguration "P+N+E, 6h".

IEC60309DCWhite

string

Industrial White Connector ist ein DC-Stecker, der in der IEC 60309-Norm definiert ist.

IEC62196Type1

string

Stecker vom Typ 1 gemäß der Norm IEC 62196-2. Auch Yazaki nach dem ursprünglichen Hersteller oder SAE J1772 nach dem Standard genannt, der es zuerst veröffentlicht hat. Wird meist in Kombination mit 120V einphasigen oder bis zu 240 V Einphaseninfrastruktur verwendet.

IEC62196Type1CCS

string

Typ 1-basierter Kombinationsstecker, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-1-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC), um das DC-Schnellladen zu ermöglichen.

IEC62196Type2CCS

string

Typ 2-basierte Kombinationssteckverbinder, wie in der IEC 62196-3-Norm definiert. Der Stecker basiert auf dem Typ-2-Stecker – wie in der IEC 62196-2-Norm definiert – mit zwei zusätzlichen Gleichstromkontakten (DC) zum Dc-Schnellladen.

IEC62196Type2CableAttached

string

Typ 2-Stecker gemäß IEC 62196-2-Norm. Geliefert als Kabel und Stecker am Ladepunkt

IEC62196Type2Outlet

string

Typ 2-Stecker gemäß IEC 62196-2-Norm. Wird als Steckdose im Ladepunkt bereitgestellt.

IEC62196Type3

string

Stecker vom Typ 3 gemäß der Norm IEC 62196-2. Auch Scame nach dem ursprünglichen Hersteller genannt. Meist in Kombination mit bis zu 240 V einphasigen oder bis zu 420 V Dreiphaseninfrastruktur.

StandardHouseholdCountrySpecific

string

Dies sind die Standard-Haushaltsconnectors für eine bestimmte Region. Sie sind alle einphasig AC und die Standardspannung und Standard-Amperage.

Siehe auch: Steckdosentypen & – Weltstandards

Tesla

string

Der Tesla-Connector ist der regional spezifische Tesla Supercharger-Connector. D.h. es bezieht sich entweder auf den proprietären Connector von Tesla, der manchmal als Tesla Port bezeichnet wird, der meist auf Nordamerika beschränkt ist, oder auf den modifizierten Typ 2 (DC über Typ 2) in Europa.

Entity

Entitätstypquelle des Begrenzungsrahmens. Bei umgekehrter Geocodierung ist dies immer gleich der Position.

Name Typ Beschreibung
position

string

Position der Entität

EntryPoint

Der Einstiegspunkt für den zurückgegebenen POI.

Name Typ Beschreibung
position

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

type

EntryPointType

Der Typ des Einstiegspunkts. Der Wert kann entweder Standard oder Nebenwert sein.

EntryPointType

Der Typ des Einstiegspunkts. Der Wert kann entweder Standard oder Nebenwert sein.

Name Typ Beschreibung
main

string

minor

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

GeographicEntityType

Geography-Entitätstyp. Nur vorhanden, wenn entityType angefordert wurde und verfügbar ist.

Name Typ Beschreibung
Country

string

Land-/Regionsname

CountrySecondarySubdivision

string

County

CountrySubdivision

string

Bundesland oder Kanton

CountryTertiarySubdivision

string

Benannter Bereich

Municipality

string

Stadt / Ort

MunicipalitySubdivision

string

Sub/Super City

Neighbourhood

string

Nachbarschaft

PostalCodeArea

string

Postleitzahl / Postleitzahl

Geometry

Informationen über die geometrische Form des Ergebnisses. Nur vorhanden, wenn typ == Geography.

Name Typ Beschreibung
id

string

Übergeben Sie dies als geometryId an die Get Search Polygon-API, um Geometrieinformationen für dieses Ergebnis abzurufen.

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

Name Typ Beschreibung
lat

number

Latitude-Eigenschaft

lon

number

Longitude-Eigenschaft

LocalizedMapView

Mit dem Parameter View (auch als "Benutzerregion" bezeichnet) können Sie die richtigen Karten für ein bestimmtes Land/eine bestimmte Region für geopolitisch umstrittene Regionen anzeigen. Verschiedene Länder/Regionen haben unterschiedliche Ansichten zu diesen Regionen, und der View-Parameter ermöglicht es Ihrer Anwendung, die Ansicht zu erfüllen, die für das Land/die Region erforderlich ist, in dem/der Ihre Anwendung verwendet wird. Standardmäßig ist der View-Parameter auf "Unified" festgelegt, auch wenn Sie ihn nicht in der Anforderung definiert haben. Es liegt in Ihrer Verantwortung, den Standort Ihrer Benutzer zu bestimmen und dann den „View“-Parameter für diesen Standort entsprechend festzulegen. Alternativ haben Sie die Möglichkeit, „View=Auto“ festzulegen, wodurch die Kartendaten basierend auf der IP-Adresse der Anforderung zurückgibt. Der View-Parameter in Azure Maps muss in Übereinstimmung mit den geltenden Gesetzen verwendet werden, einschließlich derjenigen zur Zuordnung des Landes/der Region, in dem Karten, Bilder und andere Daten sowie Inhalte von Drittanbietern, auf die Sie über Azure Maps zugreifen dürfen, verfügbar gemacht werden. Beispiel: view=IN.

Weitere Informationen und die verfügbaren Ansichten finden Sie unter Unterstützte Ansichten .

Name Typ Beschreibung
AE

string

Vereinigte Arabische Emirate (arabische Ansicht)

AR

string

Argentinien (argentinische Ansicht)

Auto

string

Gibt die Kartendaten basierend auf der IP-Adresse der Anforderung zurück.

BH

string

Bahrain (arabische Ansicht)

IN

string

Indien (indische Ansicht)

IQ

string

Irak (arabische Ansicht)

JO

string

Jordanien (arabische Ansicht)

KW

string

Kuwait (arabische Ansicht)

LB

string

Libanon (arabische Ansicht)

MA

string

Marokko (marokkanische Ansicht)

OM

string

Oman (arabische Ansicht)

PK

string

Pakistan (pakistanische Ansicht)

PS

string

Palästinensische Autonomiegebiete (arabische Ansicht)

QA

string

Katar (arabische Ansicht)

SA

string

Saudi-Arabien (arabische Ansicht)

SY

string

Syrien (arabische Ansicht)

Unified

string

Einheitliche Ansicht (andere)

YE

string

Jemen (arabische Ansicht)

MatchType

Übereinstimmungstypen für einen Suchvorgang für umgekehrte Adressen.

Name Typ Beschreibung
AddressPoint

string

HouseNumberRange

string

Street

string

OperatingHours

Öffnungszeiten für einen POI (Points of Interest).

Name Typ Beschreibung
mode

string

In der Anforderung verwendeter Wert: none oder "nextSevenDays"

timeRanges

OperatingHoursTimeRange[]

Liste der Zeitbereiche für die nächsten 7 Tage

OperatingHoursRange

Betriebsstunden für einen POI (Points of Interest). Die Verfügbarkeit der Betriebsstunden variiert je nach verfügbaren Daten. Wenn sie nicht bestanden wird, werden keine Öffnungszeiteninformationen zurückgegeben. Unterstützter Wert: nextSevenDays

Name Typ Beschreibung
nextSevenDays

string

Zeigt die Betriebszeiten für die nächste Woche an, beginnend mit dem aktuellen Tag in der Ortszeit des POI.

OperatingHoursTime

Stellt ein Datum und eine Uhrzeit dar.

Name Typ Beschreibung
date

string

Stellt das aktuelle Kalenderdatum in der POI-Zeitzone dar, z. B. "2019-02-07".

hour

integer

Stunden sind im 24-Stunden-Format in der Ortszeit eines POI; mögliche Werte sind 0 bis 23.

minute

integer

Die Minuten liegen in der Ortszeit eines POI; mögliche Werte sind 0 bis 59.

OperatingHoursTimeRange

Geöffneter Zeitbereich für einen Tag

Name Typ Beschreibung
endTime

OperatingHoursTime

Der Punkt im Bereich der nächsten 7 Tage, an dem ein bestimmter POI geschlossen wird, oder der Anfang des Bereichs, wenn er vor dem Bereich geschlossen wurde.

startTime

OperatingHoursTime

Der Punkt im Bereich der nächsten 7 Tage, an dem ein bestimmter POI geöffnet wird, oder der Anfang des Bereichs, wenn er vor dem Bereich geöffnet wurde.

PointOfInterest

Details des zurückgegebenen POI, einschließlich Informationen wie Name, Telefon, URL-Adresse und Klassifizierungen.

Name Typ Beschreibung
brands

Brand[]

Markenarray. Der Name der Marke für den zurückgegebenen POI.

categories

string[]

Kategorienarray

categorySet

PointOfInterestCategorySet[]

Die Liste der spezifischsten POI-Kategorien

classifications

Classification[]

Klassifizierungsarray

name

string

Name der POI-Eigenschaft

openingHours

OperatingHours

Öffnungszeiten für einen POI (Points of Interest).

phone

string

Telefonnummern-Eigenschaft

url

string

Website-URL-Eigenschaft

PointOfInterestCategorySet

POI-Kategorie

Name Typ Beschreibung
id

integer

Kategorie-ID

QueryType

Der Typ der zurückgegebenen Abfrage: NEARBY oder NON_NEAR.

Name Typ Beschreibung
NEARBY

string

Search wurde um einen bestimmten Breiten- und Längengrad mit einem definierten Radius durchgeführt.

NON_NEAR

string

Search wurde global durchgeführt, ohne sich auf einen bestimmten Breiten- und Längengrad und keinen definierten Radius zu bewegen.

ResponseFormat

Gewünschtes Format der Antwort. Der Wert kann entweder json oder xml sein.

Name Typ Beschreibung
json

string

Das Datenaustauschformat der JavaScript-Objektnotation

xml

string

The Extensible Markup Language

SearchAddressResult

Dieses Objekt wird von erfolgreichen Search-Aufrufen zurückgegeben.

Name Typ Beschreibung
results

SearchAddressResultItem[]

Eine Liste mit Search API-Ergebnissen.

summary

SearchSummary

Zusammenfassungsobjekt für eine Search-API-Antwort

SearchAddressResultItem

Ergebnisobjekt für eine Search API-Antwort.

Name Typ Beschreibung
address

Address

Die Adresse des Ergebnisses

addressRanges

AddressRanges

Beschreibt den Adressbereich auf beiden Straßenseiten für ein Suchergebnis. Koordinaten für die Anfangs- und Endpositionen des Adressbereichs sind enthalten.

dataSources

DataSources

Optionaler Abschnitt Verweisen Sie auf die Geometrie-ID zur Verwendung mit der Get Search Polygon-API.

detourTime

integer

Umleitungszeit in Sekunden. Wird nur für Aufrufe der Search Route-API zurückgegeben.

dist

number

Gerader Linienabstand zwischen dem Ergebnis und der Geobias-Position in Metern.

entityType

GeographicEntityType

Geography-Entitätstyp. Nur vorhanden, wenn entityType angefordert wurde und verfügbar ist.

entryPoints

EntryPoint[]

Array von EntryPoints. Diese beschreiben die Arten von Eingängen, die am Standort verfügbar sind. Der Typ kann "Standard" für Standard Eingänge wie eine Eingangstür oder eine Lobby und "Minor" für Seiten- und Hintertüren sein.

id

string

ID-Eigenschaft

info

string

Informationen zur ursprünglichen Datenquelle des Ergebnisses. Wird für Supportanfragen verwendet.

matchType

MatchType

Informationen zum Übereinstimmungstyp.

Enthält einen der folgenden Werte:

  • AddressPoint
  • HouseNumberRange
  • Straße
poi

PointOfInterest

Details des zurückgegebenen POI, einschließlich Informationen wie Name, Telefon, URL-Adresse und Klassifizierungen.

position

LatLongPairAbbreviated

Ein Ort, der als Breiten- und Längengrad mit dem Kurznamen "lat" & "lon" dargestellt wird.

score

number

Der Wert innerhalb eines Resultsets, um den relativen Abgleichswert zwischen den Ergebnissen anzugeben. Sie können dies verwenden, um zu bestimmen, dass ergebnis x doppelt so wahrscheinlich so relevant ist wie ergebnis y, wenn der Wert von x 2x dem Wert von y entspricht. Die Werte variieren zwischen Abfragen und sind nur als relativer Wert für ein Resultset gedacht.

type

SearchAddressResultType

Enthält einen der folgenden Werte:

  • POI
  • Straße
  • Gebiet
  • Punktadresse
  • Adressbereich
  • Querstraße
viewport

BoundingBox

Der Viewport, der das Ergebnis abdeckt, das durch die koordinaten oben links und unten rechts des Viewports dargestellt wird.

SearchAddressResultType

Enthält einen der folgenden Werte:

  • POI
  • Straße
  • Gebiet
  • Punktadresse
  • Adressbereich
  • Querstraße
Name Typ Beschreibung
Address Range

string

Cross Street

string

Geography

string

POI

string

Point Address

string

Street

string

SearchIndexes

Indizes, für die erweiterte Postleitzahlen in die Ergebnisse aufgenommen werden sollten.

Verfügbare Indizes sind:

Addr = Adressbereiche

Geo = Geographie

PAD = Punktadressen

POI = Points of Interest

Str = Straßen

XStr = Cross Street (Kreuzungen)

Der Wert sollte eine durch Kommage getrennte Liste von Indextypen (in beliebiger Reihenfolge) oder Keine für keine Indizes sein.

Standardmäßig sind erweiterte Postleitzahlen für alle Indizes mit Ausnahme von Geo enthalten. Erweiterte Postleitzahlenlisten für Geografische Regionen können recht lang sein, sodass sie bei Bedarf explizit angefordert werden müssen.

Anwendungsbeispiele:

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Erweiterte Postleitzahl wird als extendedPostalCode-Eigenschaft einer Adresse zurückgegeben. Die Verfügbarkeit ist regionsabhängig.

Name Typ Beschreibung
Addr

string

Geo

string

PAD

string

POI

string

Str

string

Xstr

string

SearchSummary

Zusammenfassungsobjekt für eine Search-API-Antwort.

Name Typ Beschreibung
fuzzyLevel

integer

Die maximale Fuzzyebene, die erforderlich ist, um Ergebnisse bereitzustellen.

geoBias

LatLongPairAbbreviated

Angabe, wenn die interne Suchmaschine eine georedundante Verzerrung angewendet hat, um die Rangfolge der Ergebnisse zu verbessern. In einigen Methoden kann dies durch Festlegen der Lat- und lon-Parameter beeinflusst werden, sofern verfügbar. In anderen Fällen ist es rein intern.

limit

integer

Maximale Anzahl von Antworten, die zurückgegeben werden

numResults

integer

Anzahl der Ergebnisse in der Antwort.

offset

integer

Der Startoffset der zurückgegebenen Ergebnisse innerhalb des vollständigen Resultsets.

query

string

Der Abfrageparameter, der zum Erstellen dieser Suchergebnisse verwendet wurde.

queryTime

integer

Der Zeitaufwand für das Auflösen der Abfrage in Millisekunden.

queryType

QueryType

Der Typ der zurückgegebenen Abfrage: NEARBY oder NON_NEAR.

totalResults

integer

Die Gesamtzahl der gefundenen Ergebnisse.