Bing Kaarten Een locatie zoeken op query-API migreren

2024-05-17

In dit artikel wordt uitgelegd hoe u de Bing Kaarten Een locatie zoeken op query-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, een plaats of oriëntatiepunt. Azure Kaarten Get Geocoding-API ondersteunt geocoderingsinvoer in een ongestructureerde of gestructureerde indeling. Deze migratiedocumentatie is bedoeld voor scenario's waarin uw geocoderingsinvoer, zoals adres, plaats, postcode of naam van oriëntatiepunt, zich in een ongestructureerde indeling (query=) bevindt, vergelijkbaar met wat Bing Kaarten Zoeken naar een locatie door query-API ondersteunt. Zie Bing Kaarten Een locatie zoeken op adres voor informatie over het migreren van Bing Kaarten-scenario's waarin de invoer voor geocodering is gestructureerd om een locatie op adres te vinden.

Vereisten

Een Azure-account
Een Azure Kaarten-account
Een abonnementssleutel of een andere vorm van verificatie met Azure Kaarten

Belangrijke verschillen

Bing Kaarten Een locatie zoeken op query-API ondersteunt alleen geocoderingsinvoer in ongestructureerde indeling, terwijl Azure Kaarten Get Geocoding-API ondersteuning biedt voor geocoderingsinvoer 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 query-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 Find a Location by Query API ondersteunt xml- en JSON-antwoordindeling. Azure Kaarten Get Geocoding-API ondersteunt GeoJSON.
In tegenstelling tot Bing Kaarten Een locatie zoeken op query-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 query-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 queryaanvraag en het equivalent van Azure Kaarten:

Bing Kaarten aanvraagparameter	Bing Kaarten aanvraagparameteralias	Azure Kaarten-aanvraagparameter	Vereist in Azure Kaarten	Azure Kaarten-gegevenstype	Beschrijving
cultuur	c	Aanvraagheader: Accept-Language	Onwaar	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.
include	Incl	Niet nodig	Niet nodig	Niet vereist	In Bing Kaarten Een locatie zoeken op query-API is de `include` invoerparameter vereist om een ISO-landcode van twee letters op te halen voor het locatieresultaat in het antwoord (include=ciso2) en om op te geven dat het antwoord laat zien hoe de queryreeks is geparseerd in adreswaarden (include=queryParse). In Azure Kaarten Geocoderings-API ophalen, wordt de ISO-landcode met twee letters standaard geretourneerd en biedt geen ondersteuning voor een queryParse-equivalent.
includeNeighborhood	inclnb	Niet nodig	Niet nodig	Niet vereist	In Azure Kaarten Geocoderings-API ophalen, wordt standaard buurtinformatie geretourneerd in het antwoord, indien beschikbaar.
maxResultaten	maxRes	Boven	Onwaar	Geheel getal (int32)	In Azure Kaarten Geocoderings-API ophalen is het standaardaantal geretourneerde antwoorden 5. Het minimum is 1 en het maximum is 20.
query	k	Query	Waar	tekenreeks
userIp	Uip	Niet ondersteund	Niet ondersteund	Niet ondersteund
userLocation	Ul	Coördinaten	Onwaar	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 rekening gehouden met de locatie van de gebruiker en zijn de geretourneerde resultaten relevanter voor de gebruiker.
userMapView	umv	Bbox	Onwaar	getal[]	Een rechthoekig gebied op de aarde gedefinieerd als een begrenzingsvakobject. De zijden van de rechthoeken worden gedefinieerd door lengte- en breedtegraadwaarden (lengtegraad1,breedtegraad1,lengtegraad2,breedtegraad2). 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	ur	Bekijken	Onwaar	tekenreeks	Een tekenreeks die een ISO 3166-1 Alfa-2-regio/landcode vertegenwoordigt. Hierdoor worden geopolitieke betwiste randen en labels gewijzigd zodat deze overeenkomen 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 per POST-aanvraag voor query-API:

http://dev.virtualearth.net/REST/v1/Locations/15127 NE 24th Street Redmond WA&key={BingMapsKey}

Azure Kaarten Get Geocoding API POST request:

https://atlas.microsoft.com/geocode?api-version=2023-06-01&query=15127 NE 24th Street Redmond WA&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 queryaanvraag 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 query-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	`formattedAddress`is het equivalent van Azure Kaarten.
punt (JSON) Punt (XML)	functies: coördinaten	In Bing Kaarten Een locatie zoeken op query-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 queryaanvraag:

{ 
    "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": "7896468b37528ac145ef77cc62484fd6|MWH0032BE2|0.0.0.1|Ref A: 7D01B283F7644D2891600E265FB30B24 Ref B: CO1EDGE2318 Ref C: 2024-04-23T18:29:55Z"

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:

{
    "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 zoals Bing Kaarten Een locatie zoeken op query-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

Microsoft Q&A-forum