Search - Get Geocode Autocomplete
Gebruik deze optie om een gerangschikte lijst met voorgestelde entiteiten op te halen op basis van de locatie van een gebruiker en een gedeeltelijke zoekopdracht.
Gegeven een verzoek met de locatie van een gebruiker en een gedeeltelijke query die dient als het voorvoegsel van een volledige querystring (aangeduid als een queryvoorvoegsel), geeft de Azure Maps Autocomplete API een lijst terug van voorgestelde entiteiten waar de gebruiker waarschijnlijk naar zoekt. Deze entiteiten zijn gerangschikt van meest naar minst waarschijnlijk.
GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}
GET {endpoint}/geocode:autocomplete?api-version=2026-01-01&query={query}&coordinates={coordinates}&bbox={bbox}&top={top}&resultTypeGroups={resultTypeGroups}&resultTypes={resultTypes}&view={view}&countryRegion={countryRegion}
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
De hostnaam van de Azure Maps-service. Gebruik |
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
|
query
|
query | True |
string |
Verplicht. Het queryvoorvoegsel van de gebruiker. Voorbeeld: "1 Micro" of "Muir Woods". |
|
bbox
|
query |
number[] |
Vereist wanneer Voorbeeld: lon1,lat1,lon2,lat2. Minimale grootte: ongeveer 0,00001 graden (~0,01 meter). Maximale grootte: tot de volledige globale omvang (-180,-90 tot 180,90) |
|
|
coordinates
|
query |
number[] |
Vereist wanneer
Notitie: |
|
|
country
|
query |
string |
Signaal voor het autocomplete-resultaat naar een ISO 3166-1 Alpha-2 regio-/landcode die is opgegeven, bijv. FR. Alleen resultaten in het opgegeven land/regio worden geretourneerd. |
|
|
result
|
query |
Een door komma's gescheiden lijst van geretourneerde entiteitstypegroepen. De mogelijke waarden zijn
|
||
|
result
|
query |
Een door komma's gescheiden lijst van geretourneerde entiteitstypen. Wanneer typegroep is ingesteld op Adres, worden de volgende typen ondersteund:
Alle andere typen behoren tot de groep Plaatstype. Dit kunnen entiteiten zijn zoals AdminDivision1, Neighborhood, PopulatedPlace en meer. De standaardwaarde is alle mogelijke entiteitstypen. |
||
|
top
|
query |
integer (int32) minimum: 1maximum: 20 |
Maximum aantal antwoorden dat wordt geretourneerd. Standaard: 5, minimum: 1 en maximum: 20. |
|
|
view
|
query |
string |
Een tekenreeks die een ISO 3166-1 alfa-2 regio/landcodevertegenwoordigt. Hierdoor worden geopolitieke grenzen en labels gewijzigd zodat deze overeenkomen met de opgegeven gebruikersregio. De parameter Weergave is standaard ingesteld op Automatisch, zelfs als u deze niet hebt gedefinieerd in de aanvraag. Raadpleeg ondersteunde weergaven voor meer informatie en om de beschikbare weergaven te bekijken. |
Aanvraagkoptekst
| Name | Vereist | Type | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Specificeert welk account bedoeld is voor gebruik in combinatie met het Azure AD-beveiligingsmodel. Het vertegenwoordigt een unieke ID voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps beheerplane Account API. Voor meer informatie over het gebruik van Microsoft Entra ID beveiliging in Azure Maps, zie Beheer authenticatie in Azure Maps. |
|
| Accept-Language |
string |
Taal waarin zoekresultaten moeten worden geretourneerd. Raadpleeg ondersteunde talen voor meer informatie. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
De aanvraag is voltooid. Media Types: "application/geo+json", "application/json" |
|
| Other Status Codes |
Een onverwachte foutreactie. Media Types: "application/geo+json", "application/json" Kopteksten x-ms-error-code: string |
Beveiliging
AadToken
Dit zijn de Microsoft Entra OAuth 2.0 stromen. In combinatie met Azure rolgebaseerde toegang control kan het worden gebruikt om de toegang tot Azure Maps REST-API's te controleren. Azure rolgebaseerde toegangscontroles worden gebruikt om toegang aan een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.
Voor het implementeren van scenario's raden we u aan om verificatieconceptente bekijken. Kortom, deze beveiligingsdefinitie biedt een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen uitvoeren voor specifieke API's en bereiken.
Note
- Deze beveiligingsdefinitie vereist het gebruik van de
x-ms-client-id-header om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen uit de Maps Management API-. - De
Authorization URLis specifiek voor het exemplaar van de openbare Azure-cloud. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. - Het op rollen gebaseerde toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.
- Gebruik van de Azure Maps Web SDK maakt configuratiegebaseerde installatie van een toepassing mogelijk voor meerdere gebruiksscenario's.
- Zie Overzicht van Microsoft Identity Platformvoor meer informatie over het Microsoft Identity Platform.
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Dit is een gedeelde sleutel die wordt ingericht wanneer u Een Azure Maps-account maken in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.
Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze worden uitgegeven.
Voor openbaar blootgestelde toepassingen is het raadzaam om de vertrouwelijke clienttoepassingen te gebruiken benadering voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.
Type:
apiKey
In:
header
SAS Token
Dit is een shared access Signature-token dat wordt gemaakt op basis van de bewerking List SAS op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.
Met dit token is elke toepassing gemachtigd voor toegang met op rollen gebaseerd toegangsbeheer van Azure en gedetailleerd beheer tot de vervaldatum, snelheid en regio(s) van gebruik voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen toe te staan toegang op een veiligere manier te beheren dan de gedeelde sleutel.
Voor openbaar blootgestelde toepassingen wordt aangeraden een specifieke lijst met toegestane origins te configureren voor de resource van het Account toewijzen om het genereren van misbruik te beperken en het SAS-token regelmatig te vernieuwen.
Type:
apiKey
In:
header
Voorbeelden
Autocomplete API call to search for '1 Microsoft'
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft&coordinates=-113.301894,49.201888
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"streetNumber": "1",
"streetName": "Microsoft Way",
"addressLine": "1 Microsoft Way",
"locality": "Redmond",
"adminDistricts": [
{
"name": "Washington"
},
{
"name": "King County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "98052",
"formattedAddress": "1 Microsoft Way, Redmond, Washington 98052, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "LandmarkBuilding",
"address": {
"locality": "Bellevue",
"adminDistricts": [
{
"name": "Washington"
},
{
"name": "King County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "Bellevue, Washington, United States"
},
"name": "Microsoft-Advanta C"
}
}
]
}
Autocomplete API call to search for '1 Microsoft Way, Redmond', filtered by roadblock resultTypes, place resultTypeGroups, and return empty result
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=1 Microsoft Way, Redmond&coordinates=-113.301894,49.201888&resultTypeGroups=Place&resultTypes=RoadBlock
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": []
}
Autocomplete API call to search for 'Muir Woods', filtered by address resultTypeGroups
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "Address",
"address": {
"streetName": "Muir Woods Rd",
"addressLine": " Muir Woods Rd",
"locality": "Sausalito",
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "94965",
"formattedAddress": "Muir Woods Rd, Sausalito, California 94965, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"streetName": "Muir St",
"addressLine": " Muir St",
"locality": "Grosse Pointe Farms",
"adminDistricts": [
{
"name": "Michigan"
},
{
"name": "Wayne County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "48236",
"formattedAddress": "Muir St, Grosse Pointe Farms, Michigan 48236, United States"
}
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by park and populated place resultTypes, place resultTypeGroups
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place&resultTypes=Park,PopulatedPlace
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "PopulatedPlace",
"address": {
"locality": "Muir Woods",
"adminDistricts": [
{
"name": "Georgia"
},
{
"name": "Fulton County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "30349",
"formattedAddress": "Muir Woods, Georgia 30349, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Park"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by park resultTypes
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypes=Park
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Monument"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by place resultTypeGroups
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-122.581711,37.896980&resultTypeGroups=Place
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Forest",
"address": {
"adminDistricts": [
{
"name": "Wisconsin"
},
{
"name": "Dane County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "Wisconsin"
},
"name": "Muir Woods"
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "PopulatedPlace",
"address": {
"locality": "Muir Woods",
"adminDistricts": [
{
"name": "Georgia"
},
{
"name": "Fulton County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "30349",
"formattedAddress": "Muir Woods, Georgia 30349, United States"
}
}
},
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Place",
"type": "Park",
"address": {
"adminDistricts": [
{
"name": "California"
},
{
"name": "Marin County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"formattedAddress": "California"
},
"name": "Muir Woods National Monument"
}
}
]
}
Autocomplete API call to search for 'Muir Woods', filtered by roadblock resultTypes, address resultTypeGroups
Voorbeeldaanvraag
GET https://atlas.microsoft.com/geocode:autocomplete?api-version=2026-01-01&query=Muir Woods&coordinates=-113.301894,49.201888&resultTypeGroups=Address&resultTypes=RoadBlock
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": null,
"properties": {
"typeGroup": "Address",
"type": "RoadBlock",
"address": {
"streetName": "Muir St",
"addressLine": " Muir St",
"locality": "Grosse Pointe Farms",
"adminDistricts": [
{
"name": "Michigan"
},
{
"name": "Wayne County"
}
],
"countryRegion": {
"ISO": "US",
"name": "United States"
},
"postalCode": "48236",
"formattedAddress": "Muir St, Grosse Pointe Farms, Michigan 48236, United States"
}
}
}
]
}
Definities
| Name | Description |
|---|---|
| Address |
Het adres van een geocodeerde of autocomplete-voorgestelde locatie, ontleed in gestructureerde velden.
Schaarsheid is normaal: alleen de velden die de opgeloste entiteit levert worden ingevuld. Bijvoorbeeld, |
|
Address |
Een administratieve onderverdeling die een adres bevat. Bijvoorbeeld een staat, provincie of county. Teruggegeven als één item in de ouderarray |
|
Address |
Het land of de regio waarin het adres staat, geïdentificeerd door de weergavenaam en de ISO 3166-1 Alpha-2 landcode. Beide velden kunnen in een gegeven antwoord worden weggelaten. |
|
Autocomplete |
Een enkele invoer in de |
|
Autocomplete |
De |
|
Autocomplete |
Het succesvolle responslichaam werd teruggegeven door |
|
Autocomplete |
Een classificatie van autocomplete-suggesties die door |
|
Autocomplete |
Een grove classificatie van een autocomplete suggestie in een van twee groepen. Gebruikt door |
|
Azure. |
Het foutobject. |
|
Azure. |
Een antwoord met foutdetails. |
|
Azure. |
Een object met meer specifieke informatie over de fout. Volgens Azure REST API-richtlijnen - https://aka.ms/AzureRestApiGuidelines#handling-errors. |
|
Feature |
Het |
|
Feature |
Het |
|
Geo |
Hiermee geeft u het |
|
Geo |
Een geldig |
| Intersection |
Kruispuntgegevens voor een adres worden vastgesteld als een wegkruising — de hoek waar twee of meer benoemde straten samenkomen. Alleen gevuld wanneer de opgeloste entiteit een |
Address
Het adres van een geocodeerde of autocomplete-voorgestelde locatie, ontleed in gestructureerde velden.
Schaarsheid is normaal: alleen de velden die de opgeloste entiteit levert worden ingevuld. Bijvoorbeeld, streetName en streetNumber verschijnen alleen voor adressen op straatniveau, en intersection alleen voor resultaten bij kruispunten.
| Name | Type | Description |
|---|---|---|
| addressLine |
string |
De eerste regel van het adres, meestal de straatnaam en het nummer. Bijvoorbeeld: |
| adminDistricts |
De administratieve onderverdelingen die het adres bevatten, geordend van grofst tot mooist. De eerste vermelding is meestal de eerste-orde onderverdeling (zoals een Amerikaanse staat of een Canadese provincie); Latere vermeldingen behandelen fijnere indelingen waar het land, de afhankelijkheid of regio deze definieert (zoals een county op Index 1). |
|
| countryRegion |
Het land of de regio waarin het adres staat, met de weergavenaam en de ISO 3166-1 Alpha-2 landcode. |
|
| formattedAddress |
string |
Het volledige adres wordt weergegeven als een enkele, door mensen leesbare reeks weergegeven, waarbij de componenten zijn samengevoegd volgens de conventies van het land of de regio van het adres. Voorbeeld: |
| intersection |
De details van de kruisende straat voor het adres, ingevuld wanneer de opgeloste entiteit een |
|
| locality |
string |
De locatie waar het adres valt: meestal een stad, dorp of dorp. Bijvoorbeeld: |
| neighborhood |
string |
De genoemde wijk binnen de plaats, wanneer er één wordt geïdentificeerd. |
| postalCode |
string |
De postcode van het adres, wanneer die wordt gedefinieerd. Voorbeeld: |
| streetName |
string |
Het straatnaamonderdeel van het adres, wanneer de opgeloste entiteit een straatniveau adres is. Voorbeeld: |
| streetNumber |
string |
Het huis- of gebouwnummer op straat, wanneer de opgeloste entiteit een adres op straatniveau is. Voorbeeld: |
AddressAdminDistrictsItem
Een administratieve onderverdeling die een adres bevat. Bijvoorbeeld een staat, provincie of county. Teruggegeven als één item in de ouderarray Address.adminDistricts , waarbij de entries gerangschikt zijn van grofst tot fijnst.
| Name | Type | Description |
|---|---|---|
| name |
string |
De volledige naam van de wijk. Bijvoorbeeld |
| shortName |
string |
De korte of afgekorte vorm van de onderverdelingsnaam, wanneer die wordt gedefinieerd. Bijvoorbeeld |
AddressCountryRegion
Het land of de regio waarin het adres staat, geïdentificeerd door de weergavenaam en de ISO 3166-1 Alpha-2 landcode. Beide velden kunnen in een gegeven antwoord worden weggelaten.
| Name | Type | Description |
|---|---|---|
| ISO |
string |
De ISO 3166-1 Alpha-2 landcode voor het land of de regio. Bijvoorbeeld |
| name |
string |
De weergavenaam van het land of de regio. Bijvoorbeeld: |
AutocompleteFeature
Een enkele invoer in de features array van een AutocompleteResponse, die overeenkomt met de GeoJSON Feature objectvorm.
Vertegenwoordigt één autocomplete-suggestie: classificatie (type, ), typeGroupgeanalyseerd adres en optionele plaatsnaam worden blootgesteld via properties, met een representatieve coördinaat op geometry wanneer er een beschikbaar is.
| Name | Type | Description |
|---|---|---|
| geometry |
De coördinaat van de autocomplete suggestie als een |
|
| properties |
Gestructureerde gegevens over de autocomplete-suggestie, inclusief de classificatie, het geanalyseerde adres en (voor |
|
| type |
Het |
AutocompleteProperties
De properties lading van een AutocompleteFeature. Draagt de classificatie van het resultaat (typeGroup, type), het geanalyseerde adres, en (voor veel Place-getypte resultaten) een aparte weergavenaam.
| Name | Type | Description |
|---|---|---|
| address |
Het adres van het autocomplete-resultaat, ontleed in gestructureerde velden.
|
|
| name |
string |
De weergavenaam van de voorgestelde plek. Gevuld voor |
| type |
Het specifieke entiteitstype waar het resultaat op afgaat. Bijvoorbeeld een adres, een bewoonde plek, een park of een herkenningspunt. Zie |
|
| typeGroup |
De brede classificatie van het resultaat als een adres of een benoemde plaats. Zie |
AutocompleteResponse
Het succesvolle responslichaam werd teruggegeven door Get Autocomplete. Gecodeerd als een GeoJSON FeatureCollection waarvan de features array er één Feature bevat per autocomplete suggestie, gerangschikt van meest naar minst waarschijnlijk.
| Name | Type | Description |
|---|---|---|
| features |
De array van |
|
| nextLink |
string |
Bevat de URL om de volgende pagina met resultaten op te halen als het antwoord gepagineerd is. Dit is handig wanneer het antwoord te groot is om in één oproep te worden beantwoord, waardoor gebruikers door meerdere pagina's met resultaten kunnen navigeren. |
| type |
Het |
AutocompleteResultTypeEnum
Een classificatie van autocomplete-suggesties die door Get Autocomplete zowel als invoerfilter (via de resultTypes queryparameter) als als uitvoerlabel (via het type veld op elke AutocompleteProperties) wordt gebruikt. De leden definiëren een taxonomie in gazetteer-stijl die adressen, wegsegmenten, administratieve regio's, bewoonde plaatsen, natuurlijke kenmerken en bezienswaardigheden omvat. Deze taxonomie is verdeeld in twee bredere groepen door AutocompleteResultTypeGroupsEnum: Address, die adressen en wegsegmenten omvatten; en Place, die alle andere resultaattypen omvat.
| Waarde | Description |
|---|---|
| Address |
Een specifiek straatadres. |
| AdminDivision1 |
Eerste administratieve niveau binnen het land/de regio, zoals een staat of een provincie. |
| AdminDivision2 |
Tweede administratief niveau binnen het land/de regio, zoals een county. |
| AdminDivision3 |
Derde administratief niveau binnen het land/regio, zoals een district, parochie of gemeente. |
| AdministrativeBuilding |
Een gebouw waarin overheidskantoren of openbare administratieve functies zijn ondergebracht. |
| Airport |
Een faciliteit waar vliegtuigen regelmatig opstijgen en landen, met faciliteiten voor passagiers en vracht. |
| AirportTerminal |
Een passagiersterminalgebouw binnen een luchthaven. |
| AmusementPark |
Een entertainmentfaciliteit met attracties, spelletjes en thematische attracties. |
| AncientSite |
Een plek waar archeologische resten of culturele artefacten van een oude beschaving worden bewaard. |
| Aquarium |
Een openbare faciliteit waar waterplanten en -dieren worden tentoongesteld en bestudeerd. |
| Archipelago |
Een groep of keten van eilanden. |
| Basin |
Een natuurlijke depressie in het landoppervlak, vaak omgeven door hoger gelegen terrein. |
| Battlefield |
Een locatie van een historisch belangrijke landstrijd. |
| Bay |
Een waterlichaam dat gedeeltelijk door land wordt omsloten, kleiner dan een golf en groter dan een baai. |
| Beach |
Een oever van zand, kiezelsteentjes of ander onvastgelegd sediment langs een waterlichaam. |
| Bridge |
Een constructie die een weg, spoorlijn of pad over een obstakel zoals een rivier, vallei of andere weg draagt. |
| BusinessStructure |
Een gebouw dat wordt gebruikt voor algemene zakelijke of commerciële activiteiten en niet in een specifiekere categorie valt. |
| Camp |
Een locatie met onderkomen of faciliteiten voor tijdelijke bewoning, zoals een camping of seizoensgebonden nederzetting. |
| Canal |
Een kunstmatige waterloop die wordt gebruikt voor transport, irrigatie of drainage. |
| Casino |
Een faciliteit die wordt gebruikt voor gokken en kansspelen. |
| Castle |
Een historisch versterkt gebouw of complex van gebouwen, meestal geassocieerd met een adellijke of koninklijke residentie. |
| Cave |
Een natuurlijke ondergrondse kamer of gang vormde zich in gesteente. |
| Cemetery |
Een begraafplaats of begraafplaats. |
| Channel |
Een bevaarbare waterweg tussen twee landlichamen of het hoofdstroompad van een groter waterlichaam. |
| Church |
Een gebouw dat wordt gebruikt voor openbare christelijke erediensten. |
| Cliff |
Een hoge, steile rots- of aardwand, vaak met uitzicht op een kust of vallei. |
| Coast |
Een benoemd stuk land aan de zee. |
| CommunityCenter |
Een faciliteit waar gemeenschapsactiviteiten, bijeenkomsten en sociale diensten worden georganiseerd. |
| Continent |
Een van de belangrijkste landmassa's van de aarde. |
| CountryRegion |
Een land of regio. |
| Crater |
Een cirkelvormige depressie gevormd door vulkanische activiteit of meteorietinslag. |
| CulturalRegion |
Een gebied dat wordt gekenmerkt door gedeelde culturele kenmerken, zoals taal, etniciteit of erfgoed. |
| Dam |
Een barrière die over een beek of rivier wordt gebouwd om water op te houden. |
| Delta |
Een landvorm van alluviale afzettingen is gevormd waar een rivier een groter waterlichaam ontmoet. |
| Desert |
Een groot droog gebied met schaarse vegetatie door beperkte neerslag. |
| DrainageBasin |
Een gebied land dat wordt afgewaterd door een riviersysteem en zijn zijrivieren. |
| Dune |
Een heuvel of richel van door de wind opgeblazen zand. |
| FacilityStructure |
Een gebouw dat een gespecialiseerde faciliteit huisvest, zoals een nutsinstallatie of dienstverleningsinstallatie. |
| FerryTerminal |
Een faciliteit waar passagiers en voertuigen veerboten in- en uitstappen. |
| FinancialStructure |
Een gebouw waar een bank, kredietunie of andere financiële dienstverleningsinstelling is gevestigd. |
| FireStation |
Een gebouw waar brandweerlieden, apparatuur en hulpdiensten zijn ondergebracht. |
| Forest |
Een groot stuk land dat wordt gedomineerd door bomen. |
| Fort |
Een verdedigingsleger leger of aarden wallen. |
| Garden |
Een gecultiveerde ruimte voor het tentoonstellen van sier- of wetenschappelijk gecureerde planten. |
| Geyser |
Een warmwaterbron die periodiek water- en stoomstralen laat uitbarsten. |
| Glacier |
Een aanhoudende massa ijs die langzaam beweegt onder zijn eigen gewicht. |
| GolfCourse |
Een veld aangelegd om golf te spelen. |
| GreaterPopulatedPlace |
Een stedelijk gebied of stedelijke gebied dat een bewoonde plaats bevat en verder reikt dan een bewoonde plek. |
| HigherEducationFacility |
Een hogeschool, universiteit of vergelijkbare instelling voor hoger onderwijs. |
| HistoricalSite |
Een locatie van historische betekenis, vaak bewaard gebleven als een cultureel erfgoedlocatie. |
| Hospital |
Een medische faciliteit die zowel klinische als poliklinische zorg biedt. |
| HotSpring |
Een natuurlijke bron waar geothermisch verwarmd grondwater aan het oppervlak tevoorschijn komt. |
| Ice |
Een natuurlijke massa of oppervlaktelaag van bevroren water die land of water bedekt. |
| IndigenousPeoplesReserve |
Een gebied dat wordt erkend als het thuisland van een inheems volk of gemeenschap. |
| IndustrialStructure |
Een gebouw of installatie die wordt gebruikt voor productie, productie of andere industriële activiteiten. |
| Island |
Een landmassa omringd door water, kleiner dan een continent. |
| Isthmus |
Een smalle strook land die twee grotere landmassa's verbindt en twee watermassa's scheidt. |
| Lake |
Een binnenlandse binnenstroom van stilstaand water omringd door land. |
| LandArea |
Een benoemde landregio die niet in een specifiekere geografische categorie past. |
| Landform |
Een natuurlijk landkenmerk dat niet in een specifiekere categorie valt, zoals een |
| LandmarkBuilding |
Een opmerkelijk gebouw van architectonische, culturele of historische betekenis dat dient als herkenbaar herkenningspunt. |
| Library |
Een gebouw dat een collectie boeken en andere media herbergt die beschikbaar zijn voor publiek gebruik. |
| Lighthouse |
Een kust- of havenstructuur met een navigatielicht om schepen te leiden. |
| Marina |
Een havenfaciliteit die aanlegplaatsen en diensten biedt voor kleine boten en jachten. |
| Market |
Een plek waar goederen worden gekocht en verkocht, meestal in de detailhandel. |
| MedicalStructure |
Een gebouw dat wordt gebruikt voor medische of gezondheidsgerelateerde diensten anders dan een |
| MetroStation |
Een station aan een metro, ondergrondse of ander stedelijk snelvervoersysteem. |
| MilitaryBase |
Een installatie die door de strijdkrachten wordt beheerd voor training, bevoorrading of operaties. |
| Mission |
Een complex dat wordt beheerd door een religieuze groep om gemeenschapsdiensten te verlenen en het geloof te verspreiden. |
| Monument |
Een herdenkingsstructuur of standbeeld dat wordt opgericht ter ere van een persoon, gebeurtenis of idee. |
| Mosque |
Een gebouw dat wordt gebruikt voor openbare islamitische eredienst. |
| Mountain |
Een landvorm die aanzienlijk boven de omgeving uitsteekt, meestal met steile hellingen en een duidelijk afgebakende top. |
| MountainRange |
Een verbonden reeks bergen die een aaneengesloten keten vormen. |
| MultiModalStation |
Een station dat meerdere vervoersmiddelen bedient, zoals gecombineerde spoor-, bus- of metrodiensten. |
| Museum |
Een faciliteit waar objecten van artistiek, wetenschappelijk of historisch belang worden bewaard en tentoongesteld. |
| NauticalStructure |
Een constructie gerelateerd aan maritieme of nautische activiteiten, zoals een pier, dok of boei. |
| Neighborhood |
Een lokaal erkend gebied binnen een bevolkte plek, vaak met informele of cultureel gedefinieerde grenzen. |
| Oasis |
Een vruchtbaar gebied in een woestijn dat wordt gevoed door een natuurlijke waterbron. |
| ObservationPoint |
Een uitkijkpunt of uitkijkpunt met schilderachtige uitzichten over de omgeving. |
| Ocean |
Een van de belangrijkste afdelingen van de wereldwijde oceaan van de aarde. |
| OfficeBuilding |
Een gebouw dat voornamelijk wordt gebruikt voor professionele of administratieve kantoorruimte. |
| Other |
Een suggestie die niet in een ander gedefinieerd type past. |
| Park |
Een gebied dat wordt onderhouden voor openbare recreatie of natuurschoon genot. |
| ParkingStructure |
Een meerlaagse structuur gewijd aan parkeergelegenheid voor voertuigen. |
| Pass |
Een bevaarbare route door of over een bergketen of een vergelijkbare obstakel. |
| Peninsula |
Een landmassa die in een watermassa uitsteekt en er bijna door omringd wordt. |
| Plain |
Een uitgestrekt gebied met relatief vlak of zacht golvend land. |
| Planet |
Een hemellichaam dat om een ster draait, wordt meestal gebruikt om de aarde als wortel van de geografische hiërarchie te vertegenwoordigen. |
| Plateau |
Een verhoogd gebied met relatief vlak land met steile hellingen aan één of meer zijden. |
| Playground |
Een recreatiegebied uitgerust voor kinderspelen. |
| PlayingField |
Een open ruimte die wordt gebruikt voor georganiseerde sporten. |
| Pole |
Een geografische pool, zoals de Noord- of Zuidpool. |
| PoliticalUnit |
Een zelfbesturende politieke entiteit, zoals een onafhankelijke of afhankelijke staat of territorium. |
| PopulatedPlace |
Een geconcentreerd gebied van menselijke nederzettingen, zoals een stad, dorp of dorp. |
| Port |
Een maritieme faciliteit met terminals voor het laden en lossen van watervervoer van goederen of passagiers. |
| Postcode1 |
De kleinste postcodecategorie, zoals een postcode. |
| Promontory |
Een opvallend verhoogd landvorm die uitsteekt in een laagland of waterlichaam. |
| RaceTrack |
Een baan of parcours aangelegd voor racevoertuigen, dieren of atleten. |
| RailwayStation |
Een faciliteit waar passagiers treinen in- en uitstappen. |
| Reef |
Een ondergedoken of gedeeltelijk ondergedompelde richel van rots, zand of koraal nabij het wateroppervlak. |
| ReligiousStructure |
Een gebouw dat wordt gebruikt voor religieuze eredienst of praktijk en niet in een specifiekere categorie valt, zoals |
| Reserve |
Een beschermd stuk land dat is bestemd voor natuurbescherming, wilde dieren of ander beperkt gebruik. |
| ResidentialStructure |
Een gebouw dat voornamelijk wordt gebruikt voor menselijke woningen, zoals een appartement of wooncomplex. |
| River |
Een natuurlijke waterloop die naar een lagere hoogte stroomt, meestal richting een zee, meer of een andere rivier. |
| RoadBlock |
Een straatsegment zonder specifiek huisnummer, teruggegeven wanneer de geocoderingsdienst geen exact huisnummer voor de zoekopdracht kan vinden. Ondanks de naam duidt deze waarde niet op een fysieke wegafsluiting. |
| Ruin |
Een verwoest of vervallen bouwwerk dat zijn oorspronkelijke functie niet meer vervult. |
| ScientificResearchBase |
Een faciliteit die wordt gebruikt als basis voor wetenschappelijk onderzoek, vaak in afgelegen of extreme omgevingen. |
| Sea |
Een groot zoutwatergebied dat deels door land wordt omsloten, kleiner dan een oceaan. |
| SeaplaneLandingArea |
Een watergebied dat is aangewezen voor watervliegtuigen om op te stijgen en te landen. |
| Shrine |
Een structuur of locatie die een persoon herdenkt of een heilige gebeurtenis of concept herdenkt. |
| SkiArea |
Een recreatiegebied ontwikkeld voor skiën en andere wintersporten. |
| Spring |
Een natuurlijke bron waar grondwater vanaf het aardoppervlak stroomt. |
| Stadium |
Een grote locatie met getrapte zitplaatsen voor toeschouwerssporten of evenementen. |
| StatisticalDistrict |
Een regio die is gedefinieerd voor statistische of volkstellingsdoeleinden, zoals een metropolitan statistical area of census tract. |
| Temple |
Een gebouw gewijd aan religieuze eredienst. |
| Theater |
Een locatie voor het presenteren van toneelstukken, films of andere live of opgenomen optredens. |
| TouristRailway |
Een schilderachtige of erfgoedspoorlijn werd voornamelijk gebruikt voor toerisme in plaats van regulier vervoer. |
| TouristStructure |
Een gebouw dat toeristen bedient, zoals een bezoekerscentrum of een toeristeninformatie. |
| Trailhead |
Het startpunt van een wandel-, fiets- of recreatiepad. |
| TransportationStructure |
Een constructie die transportinfrastructuur ondersteunt, zoals een tolplein, weegstation of transitschuilplaats. |
| Tunnel |
Een ondergrondse of onderwaterdoorgang voor weg-, spoor- of voetgangersvervoer. |
| Valley |
Een langgerekte laaggelegen zone tussen heuvels of bergen, vaak met een waterloop. |
| Volcano |
Een berg of heuvel gevormd door vulkanische activiteit, meestal met een krater op de top. |
| Walkway |
Een pad of verharde ondergrond die is bestemd voor voetgangersgebruik. |
| Wall |
Een geconstrueerde barrière die een doorlopende verticale grens vormt, vaak gebruikt voor verdediging, afscheiding of herdenking. |
| Waterfall |
Een punt waar een beek of rivier verticaal of steil afdaalt. |
| WaterFeature |
Een waterlichaam dat niet in een specifiekere categorie valt, zoals een |
| Wetland |
Een gebied met water verzadigd en waterplanten, zoals een moeras of moeras. |
| Winery |
Een faciliteit waar wijn wordt geproduceerd en vaak wordt aangeboden voor proeverij of verkoop. |
| Zoo |
Een faciliteit waar wilde dieren worden gehouden voor publieke tentoonstellingen en studie. |
AutocompleteResultTypeGroupsEnum
Een grove classificatie van een autocomplete suggestie in een van twee groepen. Gebruikt door Get Autocomplete zowel als invoerfilter via de resultTypeGroups queryparameter (die beperkt welke soorten suggesties worden teruggegeven) als als outputclassifier via het typeGroup veld op elk AutocompleteProperties (waarbij wordt aangegeven tot welke groep een teruggegeven suggestie behoort). De Address groep behandelt individuele adressen en straatsegmenten; de Place groep omvat alle andere entiteitstypen (administratieve regio's, bewoonde plaatsen, natuurlijke kenmerken en bezienswaardigheden).
| Waarde | Description |
|---|---|
| Address |
Suggesties die betrekking hebben op een specifiek adres of een wegsegment. |
| Place |
Suggesties die zich richten op benoemde plaatsen, waaronder bestuurlijke regio's, bewoonde plaatsen, buurten, natuurlijke kenmerken en bezienswaardigheden. Voorbeelden zijn , |
Azure.Core.Foundations.Error
Het foutobject.
| Name | Type | Description |
|---|---|---|
| code |
string |
Een van een door de server gedefinieerde set foutcodes. |
| details |
Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout. |
|
| innererror |
Een object met meer specifieke informatie dan het huidige object over de fout. |
|
| message |
string |
Een leesbare weergave van de fout. |
| target |
string |
Het doel van de fout. |
Azure.Core.Foundations.ErrorResponse
Een antwoord met foutdetails.
| Name | Type | Description |
|---|---|---|
| error |
Het foutobject. |
Azure.Core.Foundations.InnerError
Een object met meer specifieke informatie over de fout. Volgens Azure REST API-richtlijnen - https://aka.ms/AzureRestApiGuidelines#handling-errors.
| Name | Type | Description |
|---|---|---|
| code |
string |
Een van een door de server gedefinieerde set foutcodes. |
| innererror |
Interne fout. |
FeatureCollectionEnum
Het GeoJSON objecttype dat wordt gebruikt als basis van succesvolle antwoorden van de forward geocoding, reverse geocoding en autocomplete operaties (inclusief hun batchvarianten). De enige waarde is FeatureCollection, zoals gedefinieerd in RFC 7946.
Get Polygon is de enige uitzondering: de responswortel is een GeoJSON Feature, zie FeatureTypeEnum.
| Waarde | Description |
|---|---|
| FeatureCollection |
Het |
FeatureTypeEnum
Het GeoJSON objecttype voor Feature objecten. Tagt elke invoer binnen de features array van een FeatureCollection respons (geocodering, reverse geocoding, autocomplete) en verschijnt aan de wortel van de Get Polygon respons. De enige waarde is Feature, zoals gedefinieerd in RFC 7946.
| Waarde | Description |
|---|---|
| Feature |
Het |
GeoJsonObjectType
Hiermee geeft u het GeoJSON type. Moet een van de negen geldige GeoJSON-objecttypen zijn: Punt, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature en FeatureCollection.
| Waarde | Description |
|---|---|
| Point |
|
| MultiPoint |
|
| LineString |
|
| MultiLineString |
|
| Polygon |
|
| MultiPolygon |
|
| GeometryCollection |
|
| Feature |
|
| FeatureCollection |
|
GeoJsonPoint
Een geldig GeoJSON Point geometrietype. Raadpleeg RFC 7946- voor meer informatie.
| Name | Type | Description |
|---|---|---|
| bbox |
number[] (double) |
Begrenzingsvak. Gebruikte projectie - EPSG:3857. Raadpleeg RFC 7946- voor meer informatie. |
| coordinates |
number[] (double) |
Een |
| type |
string:
Point |
Hiermee geeft u het |
Intersection
Kruispuntgegevens voor een adres worden vastgesteld als een wegkruising — de hoek waar twee of meer benoemde straten samenkomen. Alleen gevuld wanneer de opgeloste entiteit een RoadIntersectionis; de ouder Address.intersection wordt verder weggelaten.
| Name | Type | Description |
|---|---|---|
| baseStreet |
string |
De hoofdstraat van het kruispunt — meestal de straat waar het adresnummer naar verwijst. |
| displayName |
string |
Een door mensen leesbare naam voor het kruispunt dat de kruisingen combineert, zoals |
| intersectionType |
string |
Een kort label dat de vorm van de kruising beschrijft. Bijvoorbeeld het onderscheiden van een gelijkvloerse kruising van een gelijkvloerse oversteek zoals een brug of viaduct. |
| secondaryStreet1 |
string |
De eerste kruisstraat die samenkomt |
| secondaryStreet2 |
string |
De tweede kruisstraat bij het kruispunt, wanneer er een aanwezig is. Bevolkt alleen bij kruispunten van drie of meer straten. |