Bing Kaarten Een locatie zoeken op adres-API ondersteunt alleen geocoderingsinvoer in gestructureerde indeling, terwijl Azure Kaarten Get Geocoding-API geocoderingsinvoer ondersteunt in een ongestructureerde (query=) of gestructureerde (addressLine=)-indeling. Gebruik Azure Kaarten Get Geocoding-API met behulp van ongestructureerde invoerindeling voor geocodering voor namen van oriëntatiepunten.
Bing Kaarten Een locatie zoeken op adres-API retourneert coördinaten in de indeling breedtegraad/lengtegraad, terwijl Azure Kaarten Get Geocoding-API coördinaten retourneert in de indeling lengtegraad/breedtegraad, zoals gedefinieerd door de GeoJSON-indeling.
Bing Kaarten Een locatie zoeken op adres-API ondersteunt XML- en JSON-antwoordindeling. Azure Kaarten Get Geocoding-API ondersteunt GeoJSON.
In tegenstelling tot Bing Kaarten Een locatie zoeken op adres-API, heeft Azure Kaarten Get Geocoding-API een view invoerparameter. Dit is een tekenreeks die een ISO 3166-1 Alpha-2-regio/landcode vertegenwoordigt. De view invoerparameter wijzigt geopolitieke betwiste randen en labels zodat deze overeenkomen met de opgegeven gebruikersregio. Zie URI-parameters voor meer informatie.
In tegenstelling tot Bing Kaarten Een locatie zoeken op adres-API, biedt Azure Kaarten Get Geocoding-API momenteel geen ondersteuning voor adresgeocodering voor China, Japan of Zuid-Korea.
In tegenstelling tot Bing Kaarten voor Ondernemingen is Azure Kaarten een wereldwijde service die ondersteuning biedt voor het opgeven van een geografisch bereik, waardoor limieten voor gegevenslocatie naar de geografische gebieden (EU) of Verenigde Staten (VS) (geografische gebieden) worden toegestaan. Alle aanvragen (inclusief invoergegevens) worden uitsluitend verwerkt in het opgegeven geografische gebied. Zie het geografische bereik voor meer informatie.
Verificatie en beveiliging
Bing Kaarten voor Enterprise biedt alleen ondersteuning voor VERIFICATIE van API-sleutels. Azure Kaarten ondersteunt meerdere manieren om uw API-aanroepen te verifiëren, zoals een abonnementssleutel, Microsoft Entra-id en SAS-token (Shared Access Signature). Zie verificatie met Azure Kaarten en de sectie Beveiliging in de documentatie over Geocodering voor meer informatie over beveiliging en verificatie in Azure Kaarten Kaarten.
Aanvraagparameters
De volgende tabel bevat de parameters voor Bing Kaarten Een locatie zoeken op adresaanvraag en het equivalent van Azure Kaarten:
Bing Kaarten aanvraagparameter
Bing Kaarten aanvraagparameteralias
Azure Kaarten-aanvraagparameter
Vereist in Azure Kaarten
Azure Kaarten-gegevenstype
Beschrijving
Bing Kaarten aanvraagparameter
Bing Kaarten aanvraagparameteralias
Azure Kaarten-aanvraagparameter
Vereist in Azure Kaarten
Azure Kaarten-gegevenstype
Opmerking
addressLine
addressLine
Valse
Tekenreeks
In Azure Kaarten Get Geocoding-API, een adres of adres met lokaliteit en adminDistrictwordt invoer ondersteund voor addressLine.
adminDistrict
adminDistrict
Valse
Tekenreeks
countryRegion
countryRegion
Valse
Tekenreeks
Plaats
Plaats
Valse
Tekenreeks
Postcode
Postcode
Valse
Tekenreeks
Cultuur
C
Aanvraagheader: Accept-Language
Valse
Tekenreeks
Zoals opgegeven in de Aanvraagheader van Azure Kaarten definieert culture u de taal die wordt gebruikt in zoekresultaten bij het gebruik van de Azure Kaarten Get Geocoding-API. Zie Ondersteunde talen voor meer informatie.
opnemen
Incl
Niet nodig
Niet nodig
Niet nodig
In Bing Kaarten Een locatie zoeken op adres-API is de invoerparameter 'include' vereist om een ISO-landcode van twee letters op te halen voor het locatieresultaat in het antwoord (include=ciso2). In Azure Kaarten Geocoderings-API ophalen, wordt de ISO-landcode met twee letters standaard geretourneerd.
includeNeighborhood
inclnb
Niet nodig
Niet nodig
Niet nodig
In Azure Kaarten Geocoderings-API ophalen, wordt standaard buurtinformatie geretourneerd in het antwoord, indien beschikbaar.
maxResults
maxRes
Boven
Valse
Geheel getal (int32)
In Azure Kaarten Geocoderings-API ophalen is het standaardaantal geretourneerde antwoorden 5. Het minimum is 1 en het maximum is 20.
strictMatch
Sm
Niet ondersteund
Niet ondersteund
Niet ondersteund
userIp
Uip
Niet ondersteund
Niet ondersteund
Niet ondersteund
userLocation
Ul
Coördinaten
Valse
getal[]
In Azure Kaarten Geocoderings-API ophalen, coördinaten op aarde die zijn opgegeven als lengtegraad en breedtegraad (lengtegraad, breedtegraad). Wanneer u deze parameter opgeeft, wordt de locatie van de gebruiker beschouwd en zijn de geretourneerde resultaten relevanter voor de gebruiker.
userMapView
umv
Bbox
Valse
getal[]
Een rechthoekig gebied op de aarde gedefinieerd als een begrenzingsvakobject. De zijden van de rechthoeken worden gedefinieerd door lengte- en breedtegraadwaarden (longitude1,latitude1,longitude2,latitude2). Gebruik de volgende syntaxis om een begrenzingsvak op te geven:
Zie URI-parameters voor meer informatie over de Azure Kaarten Get Geocoding API request parameters.
Voorbeelden van aanvragen
Bing Kaarten Een locatie zoeken op POST-aanvraag van adres-API:
HTTP
http://dev.virtualearth.net/REST/v1/Locations/US/WA/Redmond/15127 NE 24th Street?&key={BingMapsKey}
Azure Kaarten Get Geocoding API POST request:
HTTP
https://atlas.microsoft.com/geocode?api-version=2023-06-01&adminDistrict=WA&locality=Redmond&addressLine=15127 NE 24th Street&subscription-key={Your-Azure-Maps-Subscription-key}
Antwoordvelden
De volgende tabel bevat de velden die in het HTTP-antwoord kunnen worden weergegeven bij het uitvoeren van de Bing Kaarten Een locatie zoeken op adresaanvraag en het equivalent van Azure Kaarten:
Bing Kaarten-veld
Azure Kaarten Field
Beschrijving
adres: addressLine (JSON)
Adres: AddressLine (XML)
adres: addressLine
adres: adminDistrict (JSON)
Adres: Beheer District (XML)
adres: adminDistricts
adres: adminDistrict2 (JSON)
Adres: Beheer District2 (XML)
adres: adminDistricts
adres: countryRegion (JSON)
Adres: CountryRegion (XML)
adres: countryRegion
adres: countryRegionIso2 (JSON)
Adres: CountryRegionIso2 (XML)
adres: countryRegion - iso
adres: buurt (JSON)
Adres: Buurt (XML)
adres: buurt
adres: formattedAddress (JSON)
Adres: FormattedAddress (XML)
adres: formattedAddress
adres: lokaliteit (JSON)
Adres: Lokaliteit (XML)
adres: lokaliteit
adres: postcode (JSON)
Adres: Postcode (XML)
adres: postcode
adres: Snijpunt – baseStreet (JSON)
Adres: Snijpunt – BaseStreet (XML)
adres: snijpunt -baseStreet
adres: Snijpunt – secondaryStreet1 (JSON)
adres: snijpunt - secondaryStreet1
adres: Snijpunt – secondaryStreet2 (JSON)
Adres: Snijpunt – SecondaryStreet2 (XML)
adres: snijpunt - secondaryStreet2
adres: Snijpunt – intersectionType (JSON)
Adres: Snijpunt – IntersectionType (XML)
adres: snijpunt - intersectionType
adres: Snijpunt – displayName (JSON)
Adres: Snijpunt – DisplayName (XML)
adres: snijpunt - displayName
bbox (JSON)
BoundingBox (XML)
functies: bbox
In Bing Kaarten Een locatie zoeken op adres-API hebben de coördinaten in het antwoord de indeling breedtegraad/lengtegraad. De coördinaten in het antwoord van de Azure Kaarten Get Geocoding-API hebben de indeling lengtegraad/breedtegraad (omdat geoJSON-indeling wordt gebruikt).
calculationMethod (JSON)
CalculationMethod (XML)
eigenschappen: geocodePoints - calculationMethod
betrouwbaarheid (JSON)
Betrouwbaarheid (XML)
eigenschappen: betrouwbaarheid
entityType (JSON)
EntityType (XML)
eigenschappen: type
geocodePoints (JSON)
GeocodePoint (XML)
eigenschappen: geocodePoints - coördinaten
matchCodes (JSON)
MatchCode (XML)
eigenschappen: matchCodes
name (JSON)
Naam (XML)
Niet ondersteund
formattedAddressis het equivalent van Azure Kaarten.
punt (JSON)
Punt (XML)
functies: coördinaten
In Bing Kaarten Een locatie zoeken op adres-API hebben de coördinaten in het antwoord de indeling breedtegraad/lengtegraad. De coördinaten in het antwoord van de Azure Kaarten Get Geocoding-API hebben de indeling lengtegraad/breedtegraad (omdat geoJSON-indeling wordt gebruikt).
In het volgende JSON-voorbeeld ziet u wat wordt geretourneerd in de hoofdtekst van het HTTP-antwoord bij het uitvoeren van de Bing Kaarten Een locatie zoeken op adresaanvraag:
In het volgende JSON-voorbeeld ziet u wat wordt geretourneerd in de hoofdtekst van het HTTP-antwoord bij het uitvoeren van een Azure Kaarten Get Geocoding-aanvraag:
Net als Bing Kaarten Een locatie zoeken op adres-API, registreert Azure Kaarten Get Geocoding API één factureerbare transactie per aanvraag. Zie Inzicht in Azure Kaarten-transacties voor meer informatie over Azure Kaarten-transacties.
Aanvullende informatie
Geocoderingsbatch ophalen: gebruik dit om een batch query's te verzenden naar de Get Geocoding-API in één synchrone aanvraag.