Search - Get Search POI

Dienst:

Maps

API-Version:

1.0

Verwenden Sie, um nach Sehenswürdigkeiten nach Namen zu suchen.

Die Points of Interest (POI) Search API ist eine HTTP-Anforderung GET , mit der Sie POI-Ergebnisse nach Name anfordern können. Es unterstützt auch zusätzliche Abfrageparameter, z. B. Sprache und Filtern von Ergebnissen nach Interessenbereich, gesteuert nach Land/Region oder Begrenzungsfeld. Der Endpunkt gibt nur POI-Ergebnisse zurück, die der Abfragezeichenfolge entsprechen. Die Antwort enthält POI-Details wie Adresse, Koordinatenstandort und Kategorie.

GET https://atlas.microsoft.com/search/poi/{format}?api-version=1.0&query={query}

Mit optionalen Parametern:

GET https://atlas.microsoft.com/search/poi/{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}&brandSet={brandSet}&connectorSet={connectorSet}&view={view}&openingHours=nextSevenDays

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
format	path	True	ResponseFormat	Gewünschtes 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	Der POI-Name, nach dem gesucht werden soll (z. B. "Freiheitsstatue", "Starbucks"), 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 Kategoriensatz-IDs, die verwendet werden können, um das Ergebnis auf bestimmte Punktekategorien 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 bereitgestellten Liste gehören. Die Liste der unterstützten Kategorien kann mithilfe der POI-Kategorien-API ermittelt werden. Anwendungsbeispiele: categorySet=7315 (Search Sehenswürdigkeiten aus der Kategorie Restaurant) categorySet=7315025,7315017 (Search Sehenswürdigkeiten 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[]	Kommagetrennte Zeichenfolge von Länder-/Regionscodes, z. B. FR, ES. Dadurch wird die Suche auf die angegebenen Länder/Regionen beschränkt.
extendedPostalCodesFor	query		PointOfInterestExtendedPostalCodes[]	Indizes, für die erweiterte Postleitzahlen in die Ergebnisse aufgenommen werden sollten. Verfügbare Indizes sind: POI = Points of Interest Der Wert sollte POI oder None sein, um erweiterte Postleitzahlen zu deaktivieren. Standardmäßig sind erweiterte Postleitzahlen enthalten. Anwendungsbeispiele: extendedPostalCodesFor=POI extendedPostalCodesFor=None Erweiterte Postleitzahl wird als extendedPostalCode-Eigenschaft einer Adresse zurückgegeben. Die Verfügbarkeit ist regionsabhängig.
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 sollten. Z. B. 37.337
limit	query		integer	Maximale Anzahl von Antworten, die zurückgegeben werden. Standardwert: 10, Minimum: 1 und Maximum: 100
lon	query		number double	Längengrad, bei dem die Ergebnisse verzerrt sein sollten. Z.B. -121,89
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 sollen
topLeft	query		string	Obere linke Position des Begrenzungsrahmens. Z.B. 37.553,-122.453
typeahead	query		boolean	Boolesch. Wenn das Typeahead-Flag festgelegt ist, wird die Abfrage als partielle 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.
• Der Authorization URL ist 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 genutzter Schlüssel, der bereitgestellt wird, wenn Sie ein Azure Maps-Konto im Azure-Portal erstellen oder PowerShell, CLI, Azure SDKs oder REST-API verwenden.

Mit diesem Schlüssel kann jede Anwendung auf die gesamte REST-API zugreifen. Mit anderen Worten, 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 zu verwenden, um auf Azure Maps REST-APIs zuzugreifen, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: query

SAS Token

Hierbei handelt es sich um 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 autorisiert, mit rollenbasierten Zugriffssteuerungen in Azure auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token zuzugreifen. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen zu ermöglichen, den Zugriff auf eine sicherere Weise als der freigegebene Schlüssel zu steuern.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge für die Zuordnungskontoressource zu konfigurieren, um den Renderingmissbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Search for juice bars within 5 miles of Seattle Downtown and limit the response to 5 results

Beispielanforderung

HTTP

GET https://atlas.microsoft.com/search/poi/json?api-version=1.0&query=juice bars&limit=5&lat=47.606038&lon=-122.333345&radius=8046&openingHours=nextSevenDays

Beispiel für eine Antwort

Statuscode:

200

{
  "summary": {
    "query": "juice bars",
    "queryType": "NON_NEAR",
    "queryTime": 36,
    "numResults": 5,
    "offset": 0,
    "totalResults": 12,
    "fuzzyLevel": 1,
    "geoBias": {
      "lat": 47.606038,
      "lon": -122.333345
    }
  },
  "results": [
    {
      "type": "POI",
      "id": "US/POI/p0/9223158",
      "score": 5.664,
      "dist": 667.2710170950347,
      "info": "search:ta:840539001755244-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-6240804",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "400",
        "streetName": "Pine St",
        "municipalitySubdivision": "Seattle, Central Business District",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98101",
        "extendedPostalCode": "981011628",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "400 Pine St, Seattle, WA 98101",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61138,
        "lon": -122.3374
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61228,
          "lon": -122.33873
        },
        "btmRightPoint": {
          "lat": 47.61048,
          "lon": -122.33607
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61134,
            "lon": -122.33737
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p0/9222534",
      "score": 5.663,
      "dist": 1101.6849025777728,
      "info": "search:ta:840539001760125-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-4533785",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "315",
        "streetName": "E Pine St",
        "municipalitySubdivision": "Seattle, Broadway",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98122",
        "extendedPostalCode": "9812200",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "315 E Pine St, Seattle, WA 98122",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.61518,
        "lon": -122.32768
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.61608,
          "lon": -122.32901
        },
        "btmRightPoint": {
          "lat": 47.61428,
          "lon": -122.32635
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.61523,
            "lon": -122.32768
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p1/9133689",
      "score": 5.659,
      "dist": 2649.8700791555398,
      "info": "search:ta:840539001339220-US",
      "poi": {
        "name": "Pressed Juicery",
        "phone": "+(1)-(206)-2820651",
        "brands": [
          {
            "name": "Pressed Juicery"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.pressedjuicery.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "604",
        "streetName": "1st Ave N",
        "municipalitySubdivision": "Seattle, Lower Queen Anne",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98109",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "604 1st Ave N, Seattle, WA 98109",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.6247,
        "lon": -122.35533
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.6256,
          "lon": -122.35666
        },
        "btmRightPoint": {
          "lat": 47.6238,
          "lon": -122.354
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6247,
            "lon": -122.3554
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p1/9131285",
      "score": 5.646,
      "dist": 5097.757019046541,
      "info": "search:ta:840539001743255-US",
      "poi": {
        "name": "Custom Smoothie & Sports Nutrition",
        "phone": "+(1)-(206)-5475522",
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.customsmoothie.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "462",
        "streetName": "N 34th St",
        "municipalitySubdivision": "Seattle, Fremont",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98103",
        "extendedPostalCode": "981038600",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "462 N 34th St, Seattle, WA 98103",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.65016,
        "lon": -122.35182
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.65106,
          "lon": -122.35315
        },
        "btmRightPoint": {
          "lat": 47.64926,
          "lon": -122.35049
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.64991,
            "lon": -122.3519
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "US/POI/p0/9228250",
      "score": 5.637,
      "dist": 6235.798481758295,
      "info": "search:ta:840531000416784-US",
      "poi": {
        "name": "Jamba Juice",
        "phone": "+(1)-(206)-6322060",
        "brands": [
          {
            "name": "Jamba Juice"
          }
        ],
        "categorySet": [
          {
            "id": 7315149
          }
        ],
        "url": "www.jambajuice.com",
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "yogurt/juice bar"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "4555",
        "streetName": "Stone Way N",
        "municipalitySubdivision": "Wallingford, Seattle",
        "municipality": "Seattle",
        "countrySecondarySubdivision": "King",
        "countryTertiarySubdivision": "Seattle",
        "countrySubdivisionCode": "WA",
        "postalCode": "98103",
        "extendedPostalCode": "981036600",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "4555 Stone Way N, Seattle, WA 98103",
        "localName": "Seattle",
        "countrySubdivisionName": "Washington"
      },
      "position": {
        "lat": 47.66179,
        "lon": -122.34233
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.66269,
          "lon": -122.34367
        },
        "btmRightPoint": {
          "lat": 47.66089,
          "lon": -122.34099
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.66188,
            "lon": -122.34211
          }
        }
      ]
    }
  ]
}

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
PointOfInterestExtendedPostalCodes	Indizes, für die erweiterte Postleitzahlen in die Ergebnisse aufgenommen werden sollten. Verfügbare Indizes sind: POI = Points of Interest Der Wert sollte POI oder None sein, um erweiterte Postleitzahlen zu deaktivieren. Standardmäßig sind erweiterte Postleitzahlen enthalten. Anwendungsbeispiele: extendedPostalCodesFor=POI extendedPostalCodesFor=None Erweiterte Postleitzahl wird als extendedPostalCode-Eigenschaft einer Adresse zurückgegeben. Die Verfügbarkeit ist regionsabhängig.
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
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	Name des Landes/der Region
CountrySecondarySubdivision	string	County
CountrySubdivision	string	Bundesland oder Kanton
CountryTertiarySubdivision	string	Benannter Bereich
Municipality	string	Ort/ 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

PointOfInterestExtendedPostalCodes

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

Verfügbare Indizes sind:

POI = Points of Interest

Der Wert sollte POI oder None sein, um erweiterte Postleitzahlen zu deaktivieren.

Standardmäßig sind erweiterte Postleitzahlen enthalten.

Anwendungsbeispiele:

extendedPostalCodesFor=POI

extendedPostalCodesFor=None

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

Name	Typ	Beschreibung
None	string
POI	string

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

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.