Lezen in het Engels

Share via


Bing Kaarten Een locatie zoeken op adres-API migreren

In dit artikel wordt uitgelegd hoe u de Bing Kaarten Een locatie zoeken op adres-API migreert naar de Azure Kaarten Geocoderings-API ophalen. De Azure Kaarten Get Geocoding-API wordt gebruikt voor het ophalen van lengte- en breedtegraadcoördinaten van een adres op een plaats of oriëntatiepunt. Azure Kaarten Get Geocoding-API ondersteunt geocoderingsinvoer in een ongestructureerde of gestructureerde indeling. In dit artikel worden scenario's behandeld waarin uw geocoderingsinvoer, zoals adres, een gestructureerde indeling heeft, vergelijkbaar met wat Bing Kaarten Een locatie zoeken op adres-API ondersteunt. Zie Bing Kaarten Een locatie of oriëntatiepunt migreren voor informatie over het migreren van Bing Kaarten scenario's waarbij de invoer voor geocodering niet is gestructureerd om lengte- en breedtegraadcoördinaten van een adres, een locatie of oriëntatiepunt op te halen.

Vereisten

Belangrijke verschillen

  • 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:

Lengtegraad west, Zuid-breedtegraad, Lengtegraad oost, Noord-Breedtegraad

Wanneer u deze parameter opgeeft, wordt rekening gehouden met het geografische gebied bij het berekenen van de resultaten van een locatiequery.
userRegion Uw Bekijken Valse Tekenreeks Een tekenreeks die een ISO 3166-1 Alpha-2-regio/landcode vertegenwoordigt die geopolitieke betwiste randen en labels wijzigt zodat deze overeenkomt met de opgegeven gebruikersregio. Standaard is de parameter Weergave ingesteld op Automatisch , zelfs als deze niet is gedefinieerd in de aanvraag. Zie Ondersteunde weergaven voor meer informatie over beschikbare weergaven.

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).  
queryParse (JSON)

QueryParse (XML)
Niet ondersteund
usageTypes (JSON)

usageType (XML)
eigenschappen: geocodePoints: usageTypes

Zie Definities voor meer informatie over de antwoordvelden van de Azure Kaarten Geocoderings-API ophalen.

Antwoordvoorbeelden

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:

JSON
{ 
    "authenticationResultCode": "ValidCredentials", 
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png", 
    "copyright": "Copyright © 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.", 
    "resourceSets": [ 
        { 
            "estimatedTotal": 1, 
            "resources": [ 
                { 
                    "__type": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1", 
                    "bbox": [ 
                        47.62649628242932, 
                        -122.14631082421619, 
                        47.634221717570675, 
                        -122.1310271757838 
                    ], 
                    "name": "15127 NE 24th St, Redmond, WA 98052", 
                    "point": { 
                        "type": "Point", 
                        "coordinates": [ 
                            47.630359, 
                            -122.138669 
                        ] 
                    }, 
                    "address": { 
                        "addressLine": "15127 NE 24th St", 
                        "adminDistrict": "WA", 
                        "adminDistrict2": "King County", 
                        "countryRegion": "United States", 
                        "formattedAddress": "15127 NE 24th St, Redmond, WA 98052", 
                        "locality": "Redmond", 
                        "postalCode": "98052" 
                    }, 
                    "confidence": "High", 
                    "entityType": "Address", 
                    "geocodePoints": [ 
                        { 
                            "type": "Point", 
                            "coordinates": [ 
                                47.630359, 
                                -122.138669 
                            ], 
                            "calculationMethod": "Rooftop", 
                            "usageTypes": [ 
                                "Display" 
                            ] 
                        }, 
                        { 
                            "type": "Point", 
                            "coordinates": [ 
                                47.630563, 
                                -122.1387383 
                            ], 
                            "calculationMethod": "Rooftop", 
                            "usageTypes": [ 
                                "Route" 
                            ] 
                        } 
                    ], 
                    "matchCodes": [ 
                        "Good" 
                    ] 
                } 
            ] 
        } 
    ], 
    "statusCode": 200, 
    "statusDescription": "OK", 
    "traceId": "e0a7cb31a835ffbcc7e2b8f6b1a0b4e0|MWH0032BE3|0.0.0.1|Ref A: 9BC4F0B708B04F2EA6D52CB3461458A6 Ref B: CO1EDGE1411 Ref C: 2024-04-23T23:44:47Z"

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:

JSON
{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -122.138679,
                    47.630356
                ]
            },
            "bbox": [
                -122.14632082377759,
                47.62649328242932,
                -122.1310371762224,
                47.634218717570675
            ],
            "properties": {
                "type": "Address",
                "confidence": "High",
                "matchCodes": [
                    "Good"
                ],
                "geocodePoints": [
                    {
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Display"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -122.138679,
                                47.630356
                            ]
                        }
                    },
                    {
                        "calculationMethod": "Rooftop",
                        "usageTypes": [
                            "Route"
                        ],
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -122.138685,
                                47.6305637
                            ]
                        }
                    }
                ],
                "address": {
                    "addressLine": "15127 NE 24th St",
                    "postalCode": "98052",
                    "locality": "Redmond",
                    "formattedAddress": "15127 NE 24th St, Redmond, WA 98052",
                    "countryRegion": {
                        "name": "United States",
                        "ISO": "US"
                    },
                    "adminDistricts": [
                        {
                            "shortName": "WA"
                        },
                        {
                            "shortName": "King County"
                        }
                    ]
                }
            }
        }
    ]
}

Gebruik van transacties

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.

Ondersteuning