Search - Get Reverse Geocoding
Gebruik deze optie om een adres en locatiegegevens op te halen uit de lengte- en breedtegraadcoördinaten.
De Get Reverse Geocoding-API is een HTTP-GET aanvraag die wordt gebruikt voor het vertalen van een coördinaat (bijvoorbeeld: 37.786505, -122.3862) in een begrijpelijk adres voor mensen. Handig bij het volgen van toepassingen waarbij u een GPS-feed ontvangt van het apparaat of de asset en wilt weten welk adres aan de coördinaten is gekoppeld. Dit eindpunt retourneert adresgegevens voor een bepaalde coördinaat.
GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}
GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates={coordinates}&resultTypes={resultTypes}&view={view}
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
|
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
|
coordinates
|
query | True |
number[] |
De coördinaten van de locatie die u wilt omkeren van geocode. Voorbeeld: &coördinaten=lon,lat |
|
result
|
query |
Geef entiteitstypen op die u in het antwoord wilt opnemen. Alleen de typen die u opgeeft, worden geretourneerd. Als het punt niet kan worden toegewezen aan de entiteitstypen die u opgeeft, wordt er geen locatiegegevens geretourneerd in het antwoord. De standaardwaarde is alle mogelijke entiteiten. Een door komma's gescheiden lijst met entiteitstypen die zijn geselecteerd uit de volgende opties.
Deze entiteitstypen worden geordend van de meest specifieke entiteit naar de minst specifieke entiteit. Wanneer entiteiten van meer dan één entiteitstype worden gevonden, wordt alleen de meest specifieke entiteit geretourneerd. Als u bijvoorbeeld Adres en AdminDistrict1 opgeeft als entiteitstypen en entiteiten zijn gevonden voor beide typen, worden alleen de gegevens van de adresentiteit geretourneerd in het antwoord. |
||
|
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 servicehoofd kan toegang krijgen via een ingebouwde rol of een aangepaste rol bestaande uit één of meer permissies om REST-API's te Azure Maps.\n\nOm scenario's te implementeren raden we aan om authenticatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van applicatie(s) via objecten die toegang hebben tot specifieke API's en scopes.\n\n#### Notities\n* Deze beveiligingsdefinitie ree het gebruik van de x-ms-client-id header om aan te geven tot welke Azure Maps resource de applicatie toegang vraagt. Dit kan worden verkregen via de Maps management API.\n* \nDe Authorization URL is specifiek voor de Azure publieke cloud-instantie. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. \n* \nDe Azure rolgebaseerde toegangscontrole wordt geconfigureerd vanaf het Azure beheerplane via Azure portaal, PowerShell, CLI, Azure-SDK's of REST API's.\n* \nGebruik van de Azure Maps Web SDK maakt configuratie-gebaseerde opstelling van een applicatie voor meerdere gebruikssituaties mogelijk.\n* Voor meer informatie over Microsoft identity platform, zie Microsoft identity platform overzicht.
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 ingesteld wanneer je >
Type:
apiKey
In:
header
SAS Token
Dit is een shared access signature token dat wordt aangemaakt vanuit de List SAS-operatie op de Azure Maps resource via het Azure beheervlak via Azure portaal, PowerShell, CLI, Azure-SDK's of REST API's.\n\n Met dit token is elke applicatie gemachtigd om toegang te krijgen met Azure rolgebaseerde toegangscontroles en fijnmazige controle over de vervaldatum, snelheid en regio(s) van gebruik voor de betreffende token. Met andere woorden, de SAS Token kan worden gebruikt om applicaties toegang op een veiligere manier te laten beheren dan de gedeelde sleutel.\n\n Voor publiek blootgestelde applicaties is onze aanbeveling om een specifieke lijst van toegestane oorsprongen in de Map-accountresource te configureren om rendermisbruik te beperken en de SAS-token regelmatig te vernieuwen.
Type:
apiKey
In:
header
Voorbeelden
Search point -122.138681, 47.630358
Voorbeeldaanvraag
GET {endpoint}/reverseGeocode?api-version=2026-01-01&coordinates=-122.138681,47.630358
Voorbeeldrespons
Content-Type: application/geo+json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"address": {
"countryRegion": {
"name": "United States"
},
"adminDistricts": [
{
"name": "Washington",
"shortName": "WA"
},
{
"name": "King County",
"shortName": "King Co."
}
],
"formattedAddress": "15127 NE 24th St, Redmond, Washington 98052",
"streetName": "NE 24th St",
"streetNumber": "15127",
"locality": "Redmond",
"postalCode": "98052",
"addressLine": "15127 NE 24th St"
},
"type": "Address",
"confidence": "Medium",
"matchCodes": [
"Good"
],
"geocodePoints": [
{
"geometry": {
"type": "Point",
"coordinates": [
-122.138681,
47.630358
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Display"
]
},
{
"geometry": {
"type": "Point",
"coordinates": [
-122.1386787,
47.6302179
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Route"
]
}
]
},
"geometry": {
"type": "Point",
"coordinates": [
-122.138681,
47.630358
]
},
"bbox": [
-122.14632282407,
47.626495282429325,
-122.13103917593001,
47.63422071757068
]
}
]
}
Definities
| Name | Description |
|---|---|
| Address |
Het adres van het resultaat |
|
Address |
De naam van de onderverdeling in het land of de regio voor een adres. |
|
Address |
Land of regio met de naam en ISO-code. |
|
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. |
|
Calculation |
De methode die is gebruikt voor het berekenen van het geocodepunt. |
|
Confidence |
Het betrouwbaarheidsniveau dat het geocodeerde locatieresultaat een overeenkomst is. Gebruik deze waarde met de overeenkomstcode om meer volledige informatie over de overeenkomst te bepalen. Het vertrouwen van een geocodeerde locatie is gebaseerd op veel factoren, waaronder het relatieve belang van de geocodeerde locatie en de locatie van de gebruiker, indien opgegeven. |
|
Feature |
Hiermee geeft u het |
|
Features |
Een feature-object. |
|
Features |
Eigenschappen van het kenmerk. |
|
Feature |
Het type van een functie moet Functie zijn. |
|
Geocode |
Een geocodepunt. |
|
Geocoding |
Dit object wordt geretourneerd door een geslaagde geocoderingsoproep |
|
Geo |
Hiermee geeft u het |
|
Geo |
Een geldig |
| Intersection |
Het adres van het resultaat. |
|
Match |
Een enum dat de matchcode vertegenwoordigt. |
|
Reverse |
Een enum dat het type omgekeerde geocodering vertegenwoordigt. |
|
Usage |
Een enum dat het gebruikstype vertegenwoordigt. |
Address
Het adres van het resultaat
| Name | Type | Description |
|---|---|---|
| addressLine |
string |
Adresregel met straatnaam en nummer |
| adminDistricts |
De naam van de onderverdeling in het land of de regio voor een adres. Dit element wordt doorgaans behandeld als de eerste administratieve onderverdeling, maar in sommige gevallen bevat het ook de tweede, derde of vierde orderindeling in een land, afhankelijkheid of regio. |
|
| countryRegion |
Land of regio met de naam en ISO-code. |
|
| formattedAddress |
string |
Opgemaakte adreseigenschap |
| intersection |
Het adres van het resultaat. |
|
| locality |
string |
Plaats onroerend goed |
| neighborhood |
string |
Buurt eigendom |
| postalCode |
string |
Postcode eigenschap |
| streetName |
string |
De naam van de straat uit formattedAddress |
| streetNumber |
string |
Het nummer op straat, indien beschikbaar, van formattedAddress |
AddressAdminDistrictsItem
De naam van de onderverdeling in het land of de regio voor een adres.
| Name | Type | Description |
|---|---|---|
| name |
string |
De naam voor het corresponderende adminDistrict veld, Voor adminDistrict[0], kan dit de volledige naam van de staat, zoals Washington, For adminDistrict[1], dit kan de volledige naam van de provincie zijn |
| shortName |
string |
De korte naam voor het corresponderende adminDistrict-veld, Voor adminDistrict[0], kan dit een korte naam van de staat zijn, zoals WA, For adminDistrict[1], dit kan de korte naam van de provincie zijn |
AddressCountryRegion
Land of regio met de naam en ISO-code.
| Name | Type | Description |
|---|---|---|
| ISO |
string |
ISO van land/regio |
| name |
string |
naam van land/regio |
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. |
CalculationMethodEnum
De methode die is gebruikt voor het berekenen van het geocodepunt.
| Waarde | Description |
|---|---|
| Interpolation |
Het geocodepunt werd met behulp van interpolatie gekoppeld aan een punt op een weg. |
| InterpolationOffset |
Het geocodepunt werd gekoppeld aan een punt op een weg met behulp van interpolatie met een extra offset om het punt naar de kant van de straat te verschuiven. |
| Parcel |
Het geocodepunt werd afgestemd op het midden van een perceel. |
| Rooftop |
Het geocodepunt werd gekoppeld aan het dak van een gebouw. |
ConfidenceEnum
Het betrouwbaarheidsniveau dat het geocodeerde locatieresultaat een overeenkomst is. Gebruik deze waarde met de overeenkomstcode om meer volledige informatie over de overeenkomst te bepalen.
Het vertrouwen van een geocodeerde locatie is gebaseerd op veel factoren, waaronder het relatieve belang van de geocodeerde locatie en de locatie van de gebruiker, indien opgegeven.
| Waarde | Description |
|---|---|
| High |
Als het vertrouwen is ingesteld op Als een verzoek een locatie of een weergave bevat, kan de rangschikking op de juiste manier worden gewijzigd. Een locatiequery voor 'Parijs' retourneert bijvoorbeeld 'Parijs, Frankrijk' en 'Parijs, TX', beide met |
| Medium |
In sommige situaties is het mogelijk dat de geretourneerde match niet op hetzelfde niveau is als de informatie die in het verzoek is verstrekt. In een verzoek kunnen bijvoorbeeld adresgegevens worden gespecificeerd en kan de geocode-service alleen een postcode koppelen. Als de geocodeservice in dit geval zeker weet dat de postcode overeenkomt met de gegevens, wordt de betrouwbaarheid ingesteld op Als de locatiegegevens in de query dubbelzinnig zijn en er geen aanvullende informatie is om de locaties te rangschikken (zoals de locatie van de gebruiker of het relatieve belang van de locatie), wordt de betrouwbaarheid ingesteld op Als de locatiegegevens in de query niet voldoende informatie bevatten om een specifieke locatie te geocoderen, kan een minder nauwkeurige locatiewaarde worden geretourneerd en wordt de betrouwbaarheid ingesteld op |
| Low |
Low |
FeatureCollectionEnum
Hiermee geeft u het GeoJSON type. Het enige ondersteunde objecttype is FeatureCollection. Zie RFC 7946voor meer informatie.
| Waarde | Description |
|---|---|
| FeatureCollection |
Hiermee geeft u het |
FeaturesItem
Een feature-object.
| Name | Type | Description |
|---|---|---|
| bbox |
number[] (double) |
Begrenzingsvak. Gebruikte projectie - EPSG:3857. Raadpleeg RFC 7946- voor meer informatie. |
| geometry |
Een geldig |
|
| id |
string |
Id voor geretourneerde functie |
| properties |
Eigenschappen van het kenmerk. |
|
| type |
Het type van een functie moet Functie zijn. |
FeaturesItemProperties
Eigenschappen van het kenmerk.
| Name | Type | Description |
|---|---|---|
| address |
Het adres van het resultaat |
|
| confidence |
Het betrouwbaarheidsniveau dat het geocodeerde locatieresultaat een overeenkomst is. Gebruik deze waarde met de overeenkomstcode om meer volledige informatie over de overeenkomst te bepalen. Het vertrouwen van een geocodeerde locatie is gebaseerd op veel factoren, waaronder het relatieve belang van de geocodeerde locatie en de locatie van de gebruiker, indien opgegeven. |
|
| geocodePoints |
Een verzameling geocodepunten die verschillen in de wijze waarop ze zijn berekend en het voorgestelde gebruik. |
|
| matchCodes |
Een of meer overeenkomende codewaarden die het geocoderingsniveau vertegenwoordigen voor elke locatie in het antwoord. Een geocodeerde locatie met overeenkomende codes van Op dezelfde manier impliceert een geocodeerde locatie met overeenkomende codes van Mogelijke waarden zijn:
|
|
| type |
string |
Eén van: * Adres * Wegblokkade * Wegkruising * Buurt * Bewoonde Plaats * Postcode1 * AdminDivisie1 * AdminDivisie2 * LandRegio |
FeatureTypeEnum
Het type van een functie moet Functie zijn.
| Waarde | Description |
|---|---|
| Feature |
Hiermee geeft u het objecttype |
GeocodePointsItem
Een geocodepunt.
| Name | Type | Description |
|---|---|---|
| calculationMethod |
De methode die is gebruikt voor het berekenen van het geocodepunt. |
|
| geometry |
Een geldig |
|
| usageTypes |
Het beste gebruik voor het geocodepunt. Elk geocodepunt wordt gedefinieerd als een |
GeocodingResponse
Dit object wordt geretourneerd door een geslaagde geocoderingsoproep
| Name | Type | Description |
|---|---|---|
| features |
Een reeks functies kwam terug uit de query. |
|
| nextLink |
string |
Dit is de koppeling naar de volgende pagina van de geretourneerde functies. Als dit de laatste pagina is, is dit veld niet mogelijk. |
| type |
Hiermee geeft u 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
Het adres van het resultaat.
| Name | Type | Description |
|---|---|---|
| baseStreet |
string |
Primaire straat voor de locatie. |
| displayName |
string |
Volledige naam van het snijpunt. |
| intersectionType |
string |
Type snijpunt. |
| secondaryStreet1 |
string |
De eerste kruising straat. |
| secondaryStreet2 |
string |
Indien aanwezig, de tweede kruisingsstraat. |
MatchCodesEnum
Een enum dat de matchcode vertegenwoordigt.
| Waarde | Description |
|---|---|
| Good |
Goed |
| Ambiguous |
Dubbelzinnig |
| UpHierarchy |
UpHierarchy |
ReverseGeocodingResultTypeEnum
Een enum dat het type omgekeerde geocodering vertegenwoordigt.
| Waarde | Description |
|---|---|
| Address |
Adres |
| Neighborhood |
Buurt |
| PopulatedPlace |
PopulatedPlace |
| Postcode1 |
Postcode1 |
| AdminDivision1 |
AdminDivision1 |
| AdminDivision2 |
AdminDivision2 |
| CountryRegion |
LandRegio |
UsageTypeEnum
Een enum dat het gebruikstype vertegenwoordigt.
| Waarde | Description |
|---|---|
| Display |
Beeldscherm |
| Route |
Route |