Zelfstudie: Webservice migreren vanuit Bing Kaarten

Zowel Azure Maps als Bing Maps biedt toegang tot ruimtelijke API's via REST-webservices. De API-interfaces voor deze platformen voeren vergelijkbare functies uit, maar gebruiken verschillende naamconventies en antwoordobjecten. In deze zelfstudie ziet u hoe u:

• Voorwaartse en achterwaartse geocodering
• Zoeken naar nuttige plaatsen
• Routes en routebeschrijvingen berekenen
• Een kaartafbeelding ophalen
• Een afstandsmatrix berekenen
• Tijdzone-informatie ophalen

De volgende tabel bevat de API’s van de Azure Maps-service die vergelijkbare functionaliteit bieden als de vermelde API's van de Bing Maps-service.

Service-API van Bing Maps	Service-API van Azure Maps
Automatische suggestie	Zoeken
Routebeschrijving (inclusief voor vrachtwagens)	Routebeschrijving ophalen
Afstandsmatrix	Post-routematrix
Afbeeldingen - Statische kaart	Statische kaartafbeelding ophalen
Isochronen	Routebereik ophalen
Local Insights	Routebereik ophalen zoeken +
Lokale zoekopdracht	Zoeken
Locatieherkenning (nuttige plaatsen)	Zoeken
Locaties (forward/reverse geocodering)	Zoeken
Uitlijnen op weg	Routebeschrijving posten
Services voor ruimtelijke gegevens (SDS)	Route + zoeken + andere Azure-services
Tijdzone	Tijdzone
Verkeersincidenten	Details van verkeersincident ophalen

De volgende service-API's zijn momenteel niet beschikbaar in Azure Maps:

• Geoptimaliseerde reisroutes - Gepland. De route-API van Azure Maps ondersteunt geen optimalisatie voor één voertuig voor verkopers in de buitendienst.
• Metagegevens van afbeeldingen: voornamelijk gebruikt voor het ophalen van tegel-Url's in Bing Maps. Azure Maps heeft een zelfstandige service voor het rechtstreeks openen van kaarttegels.

Azure Kaarten heeft ook deze REST-webservices:

• Azure Maps Creator – Maak een aangepaste digitale dubbel van gebouwen en spaties.
• Ruimtelijke bewerkingen – Besteed complexe ruimtelijke berekeningen en bewerkingen, zoals geofencing, uit aan een service.
• Kaarttegel ophalen : toegang tot tegels voor weg- en afbeeldingen van Azure Kaarten als raster- en vectortegels.
• Post Route Directions Batch : hiermee kunnen maximaal 1000 routeaanvragen in één batch worden gedaan gedurende een bepaalde periode. Routes worden parallel op de server berekend voor een snellere verwerking.
• Verkeersdoorstroming – Krijg toegang tot realtime gegevens over verkeerstromen op raster- en vectortegels.
• Geolocatie-API – Haal de locatie van een IP-adres op.
• Weerservices : krijg toegang tot realtime en weersvoorspellingen.

Controleer ook de volgende handleidingen voor aanbevolen procedures:

• Aanbevolen procedures voor Azure Kaarten Search-service
• Best practices voor Azure Kaarten Route-service

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

• Een Azure Kaarten-account
• Een abonnementssleutel

Notitie

Zie Verificatie beheren in Azure Kaarten voor meer informatie over verificatie in Azure Kaarten.

Geocodering van adressen

Geocodering is het proces van het converteren van een adres (zoals "1 Microsoft way, Redmond, WA") naar een coördinaat (zoals lengtegraad: -122.1298, breedtegraad: 47.64005). Coördinaten worden vervolgens vaak gebruikt om een punaise op een kaart te plaatsen of om een kaart te centreren.

Azure Maps biedt verschillende methoden voor geocodering van adressen:

• Zoekadres ophalen: geocodering van vrije vorm wordt gebruikt om één adrestekenreeks (zoals "1 Microsoft way, Redmond, WA") op te geven en de aanvraag onmiddellijk te verwerken. Deze service wordt aanbevolen voor snelle geocodering van afzonderlijke adressen.
• Get Search Address Structured: Structured address geocoding wordt gebruikt om de onderdelen van één adres op te geven, zoals de straatnaam, plaats, land/regio en postcode en de aanvraag onmiddellijk verwerken. Deze service wordt aanbevolen voor snelle geocodering van afzonderlijke adressen die al zijn geparseerd in afzonderlijke adresonderdelen.
• Post Search Address Batch: Gebruik geocodering van batchadressen om een aanvraag te maken met maximaal 10.000 adressen en deze gedurende een bepaalde periode te laten verwerken. Alle adressen worden parallel op de server gecodeerd en wanneer de volledige resultatenset is voltooid, kan deze worden gedownload. Deze service wordt aanbevolen voor geocodering van grote gegevenssets.
• Zoek fuzzy ophalen: de fuzzy zoek-API combineert adresgeocodering met nuttige zoekacties. Deze API maakt gebruik van een vrije tekenreeks die een adres, plaats, oriëntatiepunt, nuttige plaats of nuttigeplaatscategorie kan zijn en verwerkt de aanvraag direct. Deze API wordt aanbevolen waarin gebruikers in hetzelfde tekstvak naar adressen of nuttige plaatsen kunnen zoeken.
• Post Search Fuzzy Batch: Gebruik de fuzzy batchzoekopdracht om een aanvraag te maken met maximaal 10.000 adressen, plaatsen, oriëntatiepunten of nuttige plaatsen en deze gedurende een bepaalde periode te laten verwerken. Alle gegevens worden parallel op de server verwerkt en wanneer de volledige resultatenset is voltooid, kunnen ze worden gedownload.

De volgende tabellen bevatten kruisverwijzingen naar de API-parameters van Bing Maps met de vergelijkbare API-parameters in Azure Maps voor gestructureerde en vrije adresgeocodering.

Locatie op adres (gestructureerd adres)

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
addressLine	streetNumber, streetName of crossStreet
adminDistrict	countrySubdivision
countryRegion	country en countryCode
locality	municipality of municipalitySubdivision
postalCode	postalCode
maxResults (maxRes)	limit
includeNeighborhood (inclnb)	N.v.t. – Wordt altijd geretourneerd door Azure Maps, indien beschikbaar.
include (incl)	N.v.t. – De ISO2-code van het land wordt altijd geretourneerd door Azure Maps.
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Azure Kaarten biedt ook ondersteuning voor:

• countrySecondarySubdivision -Regio, districten
• countryTertiarySubdivision - Benoemde gebieden, gemeenten, kantons, gemeenten
• ofs -Paginering van de resultaten in combinatie met de maxResults-parameter.

Locatie per query (vrije adrestekenreeks)

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
query	query
maxResults (maxRes)	limit
includeNeighborhood (inclnb)	N.v.t. – Wordt altijd geretourneerd door Azure Maps, indien beschikbaar.
include (incl)	N.v.t. – De ISO2-code van het land wordt altijd geretourneerd door Azure Maps.
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Azure Kaarten biedt ook ondersteuning voor:

• typeahead - Hiermee geeft u op of de query wordt geïnterpreteerd als een gedeeltelijke invoer en de zoekopdracht de voorspellende modus (automatische suggestie/automatisch aanvullen) invoert.
• countrySet – Een door komma's gescheiden lijst met ISO2-landcodes waarin de zoekopdracht moet worden beperkt.
• lat/lon, topLeft/btmRight, radius – Geef de locatie en het gebied van de gebruiker op om de resultaten lokaal relevant te maken.
• ofs -Paginering van de resultaten in combinatie met de maxResults-parameter.

Zie Zoeken naar een locatie met behulp van Azure Kaarten Search-service s en best practices voor Azure Kaarten Search-service voor meer informatie over het gebruik van de zoekservice.

Omgekeerde geocodering naar een coördinaat (een locatie zoeken op punt)

Omgekeerde geocodering is het proces van het converteren van geografische coördinaten (zoals lengtegraad: -122.1298, breedtegraad: 47.64005) in het geschatte adres (zoals "1 Microsoft way, Redmond, WA").

Azure Maps biedt verschillende methoden voor reverse geocodering:

• Zoekadres omgekeerd ophalen: geef één geografische coördinaat op om het adres bij benadering op te halen en de aanvraag onmiddellijk te verwerken.
• Get Search Address Reverse Cross Street: Geef één geografische coördinaat op om informatie over meerdere straten (bijvoorbeeld 1e en hoofd) op te halen en de aanvraag onmiddellijk te verwerken.
• Post Search Address Reverse Batch: Maak een aanvraag met maximaal 10.000 coördinaten en laat deze gedurende een bepaalde periode verwerken. Alle gegevens worden parallel op de server verwerkt en wanneer de volledige resultatenset is voltooid, kunnen ze worden gedownload.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
point	query
includeEntityTypes	entityType – Raadpleeg de vergelijkingstabel voor entiteitstypen hieronder.
includeNeighborhood (inclnb)	N.v.t. – Wordt altijd geretourneerd door Azure Maps, indien beschikbaar.
include (incl)	N.v.t. – De ISO2-code van het land wordt altijd geretourneerd door Azure Maps.
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Zie Best practices voor Azure Kaarten Search-service voor meer informatie over zoeken in Azure Kaarten.

De Azure Kaarten omgekeerde geocoderings-API bevat functies die niet beschikbaar zijn in Bing Kaarten die nuttig kunnen zijn om te integreren bij het migreren van uw app:

• Snelheidslimietgegevens ophalen.
• Informatie over weggebruik ophalen, lokale weg, arteriële, beperkte toegang, helling, enz.
• De kant van de straat waar het coördinaat zich bevindt.

Vergelijkingstabel voor entiteitstypen

De volgende tabel bevat kruisverwijzingen naar de waarden van entiteitstypen in Bing Maps met de equivalente eigenschapsnamen in Azure Maps.

Entiteitstype in Bing Maps	Vergelijkbaar entiteitstype in Azure Maps	Beschrijving
Address		Adres
Neighborhood	Neighbourhood	Buurt
PopulatedPlace	Municipality of MunicipalitySubdivision	Stad, Plaats of voorstad of Grootstedelijk gebied
Postcode1	PostalCodeArea	Postcode of Zipcode
AdminDivision1	CountrySubdivision	Staat of Provincie
AdminDivision2	CountrySecondarySubdivison	Regio of districten
CountryRegion	Country	Naam van land
	CountryTertiarySubdivision	Buurten, Kantons, Gemeenschappen

Locatiesuggesties ophalen (automatische suggestie)

Verschillende van de zoek-API’s in Azure Maps bieden ondersteuning voor de voorspellende modus, die kan worden gebruikt voor automatische suggesties. De API voor fuzzy zoekopdrachten in Azure Maps lijkt het meest op de API voor automatische suggesties in Bing Maps. De volgende API's ondersteunen ook de voorspellende modus en voegen deze toe &typeahead=true aan de query:

• Zoekadres ophalen: een vrije adresgeocodering die wordt gebruikt om één adrestekenreeks (zoals "1 Microsoft way, Redmond, WA") op te geven en de aanvraag onmiddellijk te verwerken. Deze service wordt aanbevolen voor snelle geocodering van afzonderlijke adressen.
• Zoek fuzzy ophalen: de fuzzy zoek-API combineert adresgeocodering met nuttige zoekacties. Deze API maakt gebruik van een vrije tekenreeks die een adres, plaats, oriëntatiepunt, nuttige plaats of nuttigeplaatscategorie kan zijn en verwerkt de aanvraag direct. Deze API wordt aanbevolen waarin gebruikers in hetzelfde tekstvak naar adressen of nuttige plaatsen kunnen zoeken.
• Nuttige plaatsen ophalen: De nuttige plaats -zoekopdracht wordt gebruikt om te zoeken naar nuttige plaatsen op naam. Bijvoorbeeld: "starbucks".
• Get Search POI Category: The point of interest category search (POI) category search wordt gebruikt om te zoeken naar nuttige plaatsen per categorie. Bijvoorbeeld: restaurant.

Routes en routebeschrijvingen berekenen

Azure Maps kan worden gebruikt om routes en routebeschrijvingen te berekenen. Azure Kaarten heeft veel van dezelfde functies als de Bing Kaarten-routeringsservice, zoals:

• aankomst- en vertrektijden
• realtime verkeersroutes en verkeersroutes op basis van voorspellingen
• verschillende vervoerswijzen, rijden, wandelen, vrachtwagen
• optimalisatie van meerdere bestemmingen (verkopers in de buitendienst)

Notitie

Voor Azure Maps moeten alle routepunten coördinaten zijn. Adressen moeten eerst een geocodering krijgen.

De routeringsservice van Azure Maps biedt de volgende API's voor het berekenen van routes:

• Routebeschrijving ophalen: een route berekenen en de aanvraag direct laten verwerken. Deze API ondersteunt zowel als GETPOST aanvragen. POST aanvragen worden aanbevolen bij het opgeven van een groot aantal waypoints of bij het gebruik van veel routeopties om ervoor te zorgen dat de URL-aanvraag niet te lang wordt en problemen veroorzaakt.
• Post Route directions Batch: Maak een aanvraag met maximaal 1000 routeaanvragen en laat deze gedurende een bepaalde periode verwerken. Alle gegevens worden parallel op de server verwerkt en wanneer de volledige resultatenset is voltooid, kunnen ze worden gedownload.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
avoid	avoid
dateTime (dt)	departAt of arriveAt
distanceBeforeFirstTurn (dbft)	N.v.t.
distanceUnit (du)	N.v.t. - in Azure Maps wordt alleen het metrische systeem gebruikt.
heading (hd)	vehicleHeading
maxSolutions (maxSolns)	maxAlternatives, alternativeType, minDeviationDistance en minDeviationTime
optimize (optwz)	routeType en traffic
optimizeWaypoints (optWp)	computeBestOrder
routeAttributes (ra)	instructionsType
routePathOutput (rpo)	routeRepresentation
timeType (tt)	departAt of arriveAt
tolerances (tl)	N.v.t.
travelMode	travelMode
waypoint.n (wp.n) of viaWaypoint.n (vwp.n)	query - coördinaten in de indeling lat0,lon0:lat1,lon1….
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

De routerings-API in Azure Maps ondersteunt ook routering van vrachtwagens met dezelfde API. De volgende tabel verwijst naar de andere Bing Kaarten vrachtwagenrouteringsparameters met de vergelijkbare API-parameters in Azure Kaarten.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
dimensionUnit (dims)	N.v.t – Alleen dimensies in meters worden ondersteund.
weightUnit (wu)	N.v.t. – Alleen gewichten in kilo’s worden ondersteund.
vehicleHeight (height)	vehicleHeight
vehicleWidth (width)	vehicleWidth
vehicleLength (vl)	vehicleLength
vehicleWeight (weight)	vehicleWeight
vehicleAxles (axles)	vehicleAxelWeight
vehicleTrailers (vt)	N.v.t.
vehicleSemi (semi)	vehicleCommercial
vehicleMaxGradient (vmg)	N.v.t.
vehicleMinTurnRadius (vmtr)	N.v.t.
vehicleAvoidCrossWind (vacw)	N.v.t.
vehicleAvoidGroundingRisk (vagr)	N.v.t.
vehicleHazardousMaterials (vhm)	vehicleLoadType
vehicleHazardousPermits (vhp)	vehicleLoadType

Tip

De route-API in Azure Maps retourneert standaard alleen een samenvatting (afstand en tijden) en de coördinaten voor de route. Gebruik de parameter instructionsType om instructies per afslag op te halen. De parameter routeRepresentation kan worden gebruikt om de samenvatting en het routepad te filteren.

Zie best practices voor Azure Kaarten Route-service voor meer informatie over de Api voor Azure Kaarten route.

De Routerings-API van Azure Kaarten bevat functies die niet beschikbaar zijn in Bing Kaarten die nuttig kunnen zijn om te integreren bij het migreren van uw app:

• Ondersteuning voor de routetypen: kortste, snelste, trilling en zuinigst.
• Ondersteuning voor meer reismodi: fiets, bus, motorfiets, taxi, vrachtwagen en busje.
• Ondersteuning voor 150 routepunten.
• Bereken meerdere reistijden in één aanvraag, historisch verkeer, liveverkeer, geen verkeer.
• Aanvullende wegtypen vermijden: carpoolwegen, onverharde wegen, reeds gebruikte wegen.
• Route op basis van motorspecificaties. Routes berekenen voor voertuigen met verbrandingsmotor of elektrische voertuigen op basis van hun resterende brandstof/acculading en motorspecificaties.
• De maximale voertuigsnelheid opgeven.

Coördinaten uitlijnen met de weg

Er zijn verschillende manieren waarop u coördinaten kunt uitlijnen met wegen in Azure Maps.

• Gebruik de API voor routebeschrijvingen om coördinaten uit te lijnen op een logische route over het wegennet.
• Gebruik de Azure Maps Web SDK om afzonderlijke coördinaten uit te lijnen met de dichtstbijzijnde weg op de vectortegels.
• Gebruik de Azure Maps-vectortegels om afzonderlijke coördinaten uit te lijnen.

De API voor routebeschrijvingen gebruiken om coördinaten uit te lijnen

Azure Kaarten kan coördinaten uitlijnen op wegen met behulp van de API Routebeschrijving ophalen. Deze service kan worden gebruikt om een logische route tussen een reeks coördinaten samen te stellen en is vergelijkbaar met de API voor het uitlijnen aan wegen in Bing Maps.

De API voor routebeschrijvingen kan op twee manieren worden gebruikt om coördinaten uit te lijnen met wegen.

• Als er 150 coördinaten of minder zijn, kunnen ze worden doorgegeven als waypoints in de GET routebeschrijvings-API. Met deze methode kunnen twee verschillende typen vastgemaakte gegevens worden opgehaald; route-instructies bevatten de afzonderlijke uitlijnde waypoints, terwijl het routepad een geïnterpoleerde set coördinaten bevat die het volledige pad tussen de coördinaten vullen.
• Als er meer dan 150 coördinaten zijn, kan de POST API voor routebeschrijvingen worden gebruikt. De begin- en eindcoördinaten van de coördinaten moeten worden doorgegeven aan de queryparameter, maar alle coördinaten kunnen worden doorgegeven aan de supportingPoints parameter in de hoofdtekst van de POST aanvraag en een GeoJSON-geometrieverzameling van punten hebben opgemaakt. De enige vastgemaakte gegevens die beschikbaar zijn met deze methode, is het routepad dat een geïnterpoleerde set coördinaten is die het volledige pad tussen de coördinaten vullen. Als u een voorbeeld van deze benadering wilt zien met behulp van de servicesmodule in de Azure Kaarten Web SDK, raadpleegt u het voorbeeld van uitlijnen op een logisch routepad in de Voorbeelden van Azure Kaarten.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
points	supportingPoints – deze punten doorgeven aan de hoofdtekst van de POST aanvraag
interpolate	N.v.t.
includeSpeedLimit	N.v.t.
includeTruckSpeedLimit	N.v.t.
speedUnit	N.v.t.
travelMode	travelMode
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

De API voor routering in Azure Maps ondersteunt ook parameters voor vrachtwagenroutes binnen dezelfde API om ervoor te zorgen dat logische paden worden berekend. De volgende tabel verwijst naar de andere Bing Kaarten vrachtwagenrouteringsparameters met de vergelijkbare API-parameters in Azure Kaarten.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
dimensionUnit (dims)	N.v.t – Alleen dimensies in meters worden ondersteund.
weightUnit (wu)	N.v.t. – Alleen gewichten in kilo’s worden ondersteund.
vehicleHeight (height)	vehicleHeight
vehicleWidth (width)	vehicleWidth
vehicleLength (vl)	vehicleLength
vehicleWeight (weight)	vehicleWeight
vehicleAxles (axles)	vehicleAxelWeight
vehicleTrailers (vt)	N.v.t.
vehicleSemi (semi)	vehicleCommercial
vehicleMaxGradient (vmg)	N.v.t.
vehicleMinTurnRadius (vmtr)	N.v.t.
vehicleAvoidCrossWind (vacw)	N.v.t.
vehicleAvoidGroundingRisk (vagr)	N.v.t.
vehicleHazardousMaterials (vhm)	vehicleLoadType
vehicleHazardousPermits (vhp)	vehicleLoadType

Omdat deze methode gebruikmaakt van de API voor routebeschrijvingen, kan de volledige set opties in die service worden gebruikt voor het aanpassen van de logica die wordt gebruikt om de coördinaat uit te lijnen op wegen. Als u bijvoorbeeld een vertrektijd opgeeft, wordt er rekening gehouden met historische verkeersgegevens.

De API voor routebeschrijvingen van Azure Kaarten retourneert momenteel geen snelheidslimietgegevens, maar die kunnen worden opgehaald met behulp van de Azure Kaarten omgekeerde geocoderings-API.

De Web SDK gebruiken om coördinaten uit te lijnen

De Azure Maps Web SDK gebruikt vectortegels om de kaarten weer te geven. Deze vectortegels bevatten de onbewerkte geometriegegevens van wegen en kunnen worden gebruikt voor het berekenen van de dichtstbijzijnde weg naar een coördinaat voor eenvoudige uitlijning van afzonderlijke coördinaten. Dit is handig wanneer u wilt dat de coördinaten visueel over wegen worden weergegeven en u de Azure Kaarten Web SDK al gebruikt om de gegevens te visualiseren.

Deze benadering wordt echter alleen uitgelijnd op de wegsegmenten die in de kaartweergave zijn geladen. Wanneer u op land-/regioniveau uitzoomt, zijn er mogelijk geen weggegevens, dus uitlijnen kan niet worden uitgevoerd, maar op dat zoomniveau kan één pixel het gebied van meerdere stadsblokken vertegenwoordigen, zodat uitlijning niet nodig is. Om dit op te lossen, kan de logica voor uitlijnen steeds worden toegepast wanneer de kaart is verplaatst. Als u een volledig functioneel voorbeeld van deze uitlijningslogica wilt zien, raadpleegt u het basisvoorbeeld voor weglogica in de Voorbeelden van Azure Kaarten.

De Azure Maps-vectortegels gebruiken om coördinaten direct uit te lijnen

De vectortegels uit Azure Maps bevatten de onbewerkte geometriegegevens van wegen en kunnen worden gebruikt om het dichtstbijzijnde punt op een weg te berekenen naar een coördinaat voor eenvoudige uitlijning van afzonderlijke coördinaten. Alle wegsegmenten worden weergegeven in de sectoren op zoomniveau 15, zodat u daar tegels wilt ophalen. U kunt vervolgens de quadtree tile pyramid-formule gebruiken om te bepalen of er tegels nodig zijn en om de tegels te converteren naar geometrische elementen. Vandaar kan een bibliotheek voor ruimtelijke wiskunde, zoals turf js of NetTopologySuite, worden gebruikt voor het berekenen van de dichtstbijzijnde lijnsegmenten.

Een kaartafbeelding ophalen (statische kaart)

Azure Maps biedt een API voor het weergeven van de statische kaartafbeeldingen waarbij gegevens boven elkaar worden weergegeven. De Azure Kaarten Get Map Static Image API is vergelijkbaar met de statische kaart-API in Bing Kaarten.

Notitie

Azure Maps vereist dat het midden, alle markeringspunten en paden coördinaten zijn in de longitude,latitude-indeling, terwijl Bing Maps de latitude,longitude-indeling gebruikt. Adressen moeten eerst een geocodering krijgen.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
centerPoint	center
format	format - opgegeven als onderdeel van het URL-pad. Op dit moment wordt alleen PNG ondersteund.
heading	N.v.t. – Straatkant wordt niet ondersteund.
imagerySet	layer en style – Zie Ondersteunde kaartstijlen voor meer informatie.
mapArea (ma)	bbox
mapLayer (ml)	N.v.t.
mapSize (ms)	width en height - mag maximaal 8192 x 8192 groot zijn.
declutterPins (dcl)	N.v.t.
dpi	N.v.t.
drawCurve	path
mapMetadata	N.v.t.
pitch	N.v.t. – Straatkant wordt niet ondersteund.
pushpin (pp)	pins
zoomLevel	zoom
query	N.v.t. – Het midden of het begrenzingsvak moet worden gebruikt.
highlightEntity (he)	N.v.t.
style	N.v.t.
routeparameters	N.v.t.
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Notitie

Azure Maps maakt gebruik van een tegelsysteem met tegels die tweemaal zo groot zijn als de kaarttegels die worden gebruikt in Bing Maps. Daarom wordt de waarde van het zoomniveau in Azure Maps één niveau dichterbij weergegeven in Azure Maps dan in Bing Maps. Verlaag het zoomniveau in de aanvragen die u migreert met 1 om dit te compenseren.

Zie Aangepaste gegevens weergeven op een rasterkaart voor meer informatie.

Naast het genereren van een statische kaartafbeelding biedt de Azure Kaarten render-service ook directe toegang tot kaarttegels in rasterindeling (PNG) en vectorindeling:

• Statische kaartafbeelding ophalen : rastertegels (PNG) en vectortegels ophalen voor de basiskaarten (wegen, grenzen, achtergrond).
• Kaarttegel ophalen : tegels voor lucht- en satellietbeelden ophalen.

Vergelijking van de indeling van de URL-parameter voor de markering

Voor: Bing Kaarten

In Bing Maps kunnen markeringspunten aan een statische kaartafbeelding worden toegevoegd met behulp van de parameter pushpin in de URL. De parameter pushpin gebruikt de locatie in de latitude,longitude-indeling, een pictogramstijl en een tekstlabel (maximaal drie tekens), zoals hieronder wordt weergegeven:

&pushpin=latitude,longitude;iconStyle;label

Punaises kunnen worden toegevoegd door meer pushpin parameters toe te voegen aan de URL met een andere set waarden. De stijlen voor markeringspuntpictogrammen zijn beperkt tot een van de vooraf gedefinieerde stijlen in de API van Bing Maps.

In Bing Kaarten kan bijvoorbeeld een rode punaise met het label 'AB' worden toegevoegd aan de kaart op coördinaten (lengtegraad: -110, breedtegraad: 45) met de volgende URL-parameter:

&pushpin=45,-110;7;AB

Na: Azure Kaarten

In Azure Maps kunnen ook markeringspunten aan een statische kaartafbeelding worden toegevoegd door de parameter pins in de URL op te geven. Markeringspunten in Azure Maps worden gedefinieerd door middel van een pictogramstijl en een lijst met locaties die deze pictogramstijl gebruiken. Deze informatie wordt vervolgens doorgegeven naar de parameter pins en kan meerdere keren worden opgegeven om markeringen met verschillende stijlen te ondersteunen.

&pins=iconType|pinStyles||pinLocation1|pinLocation2|...

Er kunnen meer stijlen worden gebruikt door meer pins parameters toe te voegen aan de URL met een andere stijl en set locaties.

Met betrekking tot pincodelocaties vereist Azure Kaarten dat de coördinaten in longitude,latitude indeling zijn, terwijl Bing Kaarten de indeling gebruiktlatitude,longitude. Houd er ook rekening mee dat er een spatie staat, geen komma om de lengtegraad en breedtegraad te scheiden in Azure Maps.

De waarde iconType geeft het type markeringspunt aan dat moet worden gemaakt en kan de volgende waarden hebben:

• default - het standaardspeldpictogram.
• none – Er wordt geen pictogram weergegeven, alleen labels worden weergegeven.
• custom - geeft aan dat er een aangepast pictogram moet worden gebruikt. Een URL die wijst naar de pictogramafbeelding kan worden toegevoegd aan het einde van de parameter pins, achter de locatiegegevens van de speld.

Stijlen van markeringspunten in Azure Maps worden toegevoegd met de indeling optionNameValue, waarbij meerdere stijlen worden gescheiden door een verticale streep (|), zoals dit iconType|optionName1Value1|optionName2Value2. Let op: de optienamen en -waarden worden niet gescheiden. De volgende stijloptienamen kunnen worden gebruikt voor het opmaken van markeringspunten in Azure Maps:

• al - geeft de matheid (alfa) van de markeringspunten aan. Kan een getal tussen 0 en 1 zijn.
• an - geeft het speldanker aan. De waarden voor de x- en y-pixel opgegeven in de notatie x y.
• co - de kleur van de speld. Moet een 24-bits hexadecimale kleur zijn: 000000 tot FFFFFF.
• la - geeft de ankerkleur aan. De waarden voor de x- en y-pixel opgegeven in de notatie x y.
• lc - de kleur van het label. Moet een 24-bits hexadecimale kleur zijn: 000000 tot FFFFFF.
• ls - de grootte van het label in pixels. Kan een getal zijn dat groter is dan 0.
• ro - het aantal graden dat het pictogram moet worden gedraaid. Kan een getal tussen -360 en 360 zijn.
• sc - een schaalwaarde voor het speldpictogram. Kan een getal zijn dat groter is dan 0.

Labelwaarden worden opgegeven voor elke locatie van een markeringspunt in plaats van een enkele labelwaarde te hebben die van toepassing is op alle markeringspunten in de lijst met locaties. De labelwaarde kan bestaan uit een tekenreeks van meerdere tekens en moet worden voorzien van enkele aanhalingstekens om ervoor te zorgen dat deze niet wordt verward met een stijl- of locatiewaarde.

Voeg bijvoorbeeld in Azure Kaarten een rood (FF0000) standaardpictogram toe met het label 'Space Needle' onder (15 50) het pictogram op coördinaten (lengtegraad: -122.349300, breedtegraad: 47.620180) met de volgende URL-parameter:

&pins=default|coFF0000|la15 50||'Space Needle'-122.349300 47.620180

In het volgende voorbeeld worden drie markeringspunten toegevoegd met de labelwaarden '1', '2' en '3':

&pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12

Vergelijking van de notatie van de URL-parameter om krommen te tekenen

Voor: Bing Kaarten

In Bing Maps kunnen lijnen en veelhoeken aan een statische kaartafbeelding worden toegevoegd met behulp van de parameter drawCurve in de URL. De parameter drawCurve maakt gebruik van een vormtype, een stijltype en een lijst met locaties die op de kaart moeten worden weergegeven, zoals hieronder wordt weergegeven:

&drawCurve=shapeType,styleType,location1,location2...

Er kunnen meer stijlen worden gebruikt door meer drawCurve parameters toe te voegen aan de URL met een andere stijl en set locaties.

Locaties worden in Bing Maps opgegeven met de indeling latitude1,longitude1_latitude2,longitude2_…. Locaties kunnen ook worden gecodeerd.

Vormtypen in Bing Maps zijn onder meer lijnen, veelhoeken, cirkels en krommen. Stijltypen zijn onder andere lijnkleur, lijndikte, contourkleur, opvulkleur, contourdikte en straal van de cirkel.

In Bing Kaarten kan bijvoorbeeld een blauwe lijn met 50% dekking en een dikte van vier pixels worden toegevoegd aan de kaart tussen coördinaten (lengtegraad: -110, breedtegraad: 45 en lengtegraad: -100, breedtegraad: 50) met de volgende URL-parameter:

&drawCurve=l,FF000088,4;45,-110_50,-100

Na: Azure Kaarten

In Azure Maps kunnen ook lijnen en veelhoeken aan een statische kaartafbeelding worden toegevoegd door de path-parameter in de URL op te geven. Net als Bing Maps kunnen een stijl en een lijst met locaties worden opgegeven in deze parameter en kan de path-parameter meerdere keren worden opgegeven om meerdere cirkels, lijnen en veelhoeken met verschillende stijlen weer te geven.

&path=pathStyles||pathLocation1|pathLocation2|...

Voor padlocaties moeten de coördinaten in Azure Maps de longitude,latitude-indeling hebben. Bing Maps gebruikt daarentegen de latitude,longitude-indeling. Houd er ook rekening mee dat er een spatie staat, geen komma om de lengtegraad en breedtegraad te scheiden in Azure Maps. Azure Kaarten biedt momenteel geen ondersteuning voor gecodeerde paden.

Padstijlen in Azure Maps worden toegevoegd met de indeling optionNameValue, waarbij meerdere stijlen worden gescheiden door een verticale streep (|), zoals dit optionName1Value1|optionName2Value2. Let op: de optienamen en -waarden worden niet gescheiden. De volgende stijloptienamen kunnen worden gebruikt voor stijlpaden in Azure Maps:

• fa - De matheid (alfa) van de opvulkleur die wordt gebruikt bij het weergeven van veelhoeken. Kan een getal tussen 0 en 1 zijn.
• fc - De opvulkleur die wordt gebruikt om het gebied van een veelhoek weer te geven.
• la - de matheid (alfa) van de lijnkleur die wordt gebruikt bij het weergeven van lijnen en de contour van veelhoeken. Kan een getal tussen 0 en 1 zijn.
• lc - de lijnkleur die wordt gebruikt bij het weergeven van lijnen en de contour van veelhoeken.
• lw - de breedte van de lijn in pixels.
• ra - geeft de cirkelradius in meters aan.

In Azure Kaarten kan bijvoorbeeld een blauwe lijn met 50% dekking en een dikte van vier pixels worden toegevoegd aan de kaart tussen coördinaten (lengtegraad: -110, breedtegraad: 45 en lengtegraad: -100, breedtegraad: 50) met de volgende URL-parameter:

&path=lc0000FF|la.5|lw4||-110 45|-100 50

Een afstandsmatrix berekenen

Azure Maps biedt een API voor het berekenen van de reistijden en de afstand tussen een reeks locaties als een afstandsmatrix. De Azure Kaarten afstandsmatrix-API is vergelijkbaar met de afstandsmatrix-API in Bing Kaarten:

• Post Route Matrix: Asynchroon berekent reistijden en afstanden voor een set oorsprongen en bestemmingen. Er worden maximaal 700 cellen per aanvraag ondersteund (het aantal startpunten vermenigvuldigd met het aantal bestemmingen). Met die beperking in gedachte zijn dit voorbeelden van mogelijke matrixdimensies: 700x1, 50x10, 10x10, 28x25, 10x70.

Notitie

Een aanvraag voor de afstandsmatrix-API kan alleen worden gedaan met behulp van een POST aanvraag met de oorsprongs- en doelgegevens in de hoofdtekst van de aanvraag. Daarnaast moeten in Azure Maps alle startpunten en bestemmingen coördinaten zijn. Adressen moeten eerst een geocodering krijgen.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
origins	origins – geef in de POST aanvraagbody op als GeoJSON.
destinations	destination – geef in de POST aanvraagbody op als GeoJSON.
endTime	arriveAt
startTime	departAt
travelMode	travelMode
resolution	N.v.t.
distanceUnit	N.v.t. – Alle afstanden in meters.
timeUnit	N.v.t. – Alle tijden in seconden.
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Tip

Alle geavanceerde routeringsopties die beschikbaar zijn in de routerings-API van Azure Maps (vrachtwagenroute, motorspecificaties, vermijden ...) worden ondersteund in de afstandsmatrix-API van Azure Maps.

Een isochrone berekenen

Azure Maps biedt een API voor het berekenen van een isochrone, een veelhoek die een gebied bedekt dat in een willekeurige richting kan worden verplaatst vanaf een oorsprongspunt binnen een bepaalde tijd of hoeveelheid brandstof/acculading. De Api voor routebereik van Azure Kaarten is vergelijkbaar met de isochrone-API in Bing Kaarten.

• Routebereik : bereken een veelhoek die een gebied beslaat dat in elke richting vanaf een oorsprongspunt binnen een opgegeven hoeveelheid tijd, afstand of hoeveelheid brandstof/lading kan worden afgelegd.

Notitie

Voor Azure Maps moet de queryoorsprong een coördinaat zijn. Adressen moeten eerst een geocodering krijgen.

Bing Maps kan ook isochronen berekenen op basis van tijd of afstand, terwijl Azure Maps isochronen kan berekenen op basis van tijd, afstand of beschikbare brandstof/acculading.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
waypoint (wp)	query
dateTime (dt)	departAt
maxTime	timeBudgetInSec
timeUnit (tu)	N.v.t. – Alle tijden in seconden.
travelMode (mode)	travelMode
maxDistance (maxDis)	distanceBudgetInMeters
distanceUnit (du)	N.v.t. – Alle afstanden in meters.
optimize (optmz)	routeType
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Tip

Alle geavanceerde routeringsopties die beschikbaar zijn in de routerings-API van Azure Maps (vrachtwagenroute, motorspecificaties, vermijden ...) worden ondersteund in de isochrone-API van Azure Maps.

Zoeken naar nuttige plaatsen

In Bing Maps kan naar nuttige plaatsen worden gezocht met behulp van de volgende API’s:

• Lokale zoekopdracht: Zoekt naar nuttige plaatsen in de buurt (radiale zoekopdracht), op naam of op entiteitstype (categorie). De Azure Kaarten Get Search POI en Get Search POI Category API's zijn het meest als deze API.
• Locatieherkenning: zoekt naar nuttige plaatsen die zich op een bepaalde afstand van een locatie bevinden. De API voor zoeken in de buurt in Azure Maps lijkt het meest op deze API.
• Lokale inzichten: zoekt naar nuttige plaatsen die zich binnen een opgegeven maximale rijtijd of afstand van een specifieke coördinaat bevinden. Dit is mogelijk met Azure Kaarten door eerst een isochrone te berekenen en deze vervolgens door te geven aan de Search binnen geometrie-API.

Azure Maps biedt verschillende zoek-API's voor nuttige plaatsen:

• Nuttige plaatsen ophalen: De nuttige plaats -zoekopdracht wordt gebruikt om te zoeken naar nuttige plaatsen op naam. Bijvoorbeeld: "starbucks".
• Get Search POI Category: The point of interest category search (POI) category search wordt gebruikt om te zoeken naar nuttige plaatsen per categorie. Bijvoorbeeld: restaurant.
• Post Search Inside Geometry: Zoekt naar nuttige plaatsen die zich binnen een bepaalde afstand van een locatie of binnen een opgegeven geometrie (veelhoek) bevinden.
• Zoek fuzzy ophalen: de fuzzy zoek-API combineert adresgeocodering met nuttige zoekacties. Deze API maakt gebruik van een vrije tekenreeks die een adres, plaats, oriëntatiepunt, nuttige plaats of nuttigeplaatscategorie kan zijn en verwerkt de aanvraag direct. Deze API wordt aanbevolen waarin gebruikers in hetzelfde tekstvak naar adressen of nuttige plaatsen kunnen zoeken.
• Post Search Along Route: Zoek naar nuttige plaatsen die zich langs een opgegeven routepad bevinden.
• Post Search Fuzzy Batch: Gebruik de fuzzy batchzoekopdracht om een aanvraag te maken met maximaal 10.000 adressen, plaatsen, oriëntatiepunten of nuttige plaatsen en deze gedurende een bepaalde periode te laten verwerken. Alle gegevens worden parallel op de server verwerkt en wanneer de volledige resultatenset is voltooid, kunnen ze worden gedownload.

Zie Best practices voor Azure Kaarten Search-service voor meer informatie over zoeken in Azure Kaarten.

Verkeersincidenten ophalen

Azure Maps biedt verschillende API's voor het ophalen van verkeersgegevens. Er zijn twee soorten verkeersgegevens beschikbaar:

• Stroomgegevens – Voorzien in metrische gegevens over de verkeersstroom op delen van wegen. Deze worden vaak gebruikt om een kleurcode aan wegen toe te kennen. Deze gegevens worden om de 2 minuten bijgewerkt.
• Incidentgegevens – Voorzien in gegevens over wegwerkzaamheden, wegsluitingen, ongelukken en andere incidenten die van invloed kunnen zijn op verkeer. Deze gegevens worden om de minuut bijgewerkt.

Bing Maps biedt stroom- en incidentgegevens via de interactieve besturingselementen voor kaarten en stelt incidentgegevens ook beschikbaar als een service.

Verkeersgegevens zijn ook geïntegreerd in de interactieve besturingselementen van Azure Maps. Azure Maps biedt ook de volgende API's voor verkeersservices:

• Verkeersstroomsegment ophalen: biedt informatie over de snelheden en reistijden van het wegfragment dat het dichtst bij de opgegeven coördinaten ligt.
• Tegel Verkeersstroom ophalen: biedt raster- en vectortegels met verkeersstroomgegevens. Deze kunnen worden gebruikt met de besturingselementen in Azure Maps of in besturingselementen voor kaarten van derden, zoals Leaflet. De vectortegels kunnen ook worden gebruikt voor geavanceerde gegevensanalyse.
• Details van verkeersincident ophalen: biedt details van verkeersincidenten die zich binnen een begrenzingsvak, zoomniveau en verkeersmodel bevinden.
• Tegel Verkeersincident ophalen: biedt raster- en vectortegels met verkeersincidentgegevens.
• Get Traffic Incident Viewport: haalt de juridische en technische informatie op voor de viewport die in de aanvraag wordt beschreven, zoals de verkeersmodel-id.

De volgende tabel bevat de parameters voor de API voor verkeer in Bing Maps en de vergelijkbare parameters voor de API voor details van verkeersincidenten in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
mapArea	boundingBox en boundingZoom
includeLocationCodes	N.v.t.
severity (s)	N.v.t. – Alle gegevens worden geretourneerd
type (t)	N.v.t. – Alle gegevens worden geretourneerd
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Een tijdzone ophalen

Azure Maps biedt een API voor het ophalen van de tijdzone waarin een coördinaat zich bevindt. De Azure Kaarten tijdzone-API is vergelijkbaar met de tijdzone-API in Bing Kaarten.

• Tijdzone ophalen op coördinaten: geef een coördinaat op en haal de details op voor de tijdzone waarin deze valt.

De volgende tabel bevat de API-parameters in Bing Maps en de vergelijkbare API-parameters in Azure Maps.

API-parameter in Bing Maps	Vergelijkbare API-parameter in Azure Maps
point	query
query	N.v.t. – Adressen moeten eerst worden gegeocodeerd.
dateTime	timeStamp
includeDstRules	N.v.t. – Altijd opgenomen in de reactie door Azure Maps.
key	subscription-key– Zie Verificatie met Azure Kaarten voor meer informatie.
culture (c)	language– Zie Lokalisatieondersteuning in Azure Kaarten voor meer informatie.
userRegion (ur)	view– Zie Azure Kaarten ondersteunde weergaven voor meer informatie.

Daarnaast biedt het Azure Kaarten-platform ook veel andere tijdzone-API's om te helpen bij conversies met tijdzonenamen en -id's:

• Tijdzone ophalen op id: retourneert actuele, historische en toekomstige tijdzone-informatie voor de opgegeven IANA-tijdzone-id.
• Get Timezone Enum IANA: Retourneert een volledige lijst met IANA-tijdzone-id's. Updates in de IANA-service worden binnen één dag in het systeem doorgevoerd.
• Get Timezone Enum Windows: retourneert een volledige lijst met Windows-tijdzone-id's.
• Timezone IANA-versie ophalen: retourneert het huidige IANA-versienummer dat wordt gebruikt door Azure Kaarten.
• Get Timezone Windows To IANA: retourneert een bijbehorende IANA-id, op basis van een geldige Windows-tijdzone-id. Er kunnen meerdere IANA-id's voor één Windows-id worden geretourneerd.

Services voor ruimtelijke gegevens (SDS)

De services voor ruimtelijke gegevens in Bing Maps bieden drie belangrijke functies:

• Batchgewijze geocodering – Verwerk een grote batch met geocodes van adressen in één aanvraag.
• Gegevens van administratieve grenzen ophalen – Gebruik een coördinaat en haal een snijpuntgrens op voor een opgegeven entiteitstype.
• Ruimtelijke bedrijfsgegevens hosten en opvragen – Upload een eenvoudige 2D-gegevenstabel en open deze met enkele eenvoudige ruimtelijke query's.

Geocodegegevens batchgewijs verwerken

Bij batchgewijze geocodering wordt een groot aantal adressen of plaatsen genomen, die allemaal in één aanvraag aan een service worden doorgegeven, waarna ze in parallel worden gegeocodeerd en de resultaten in één antwoord worden geretourneerd.

Met Bing Maps kunnen maximaal 200.000 adressen worden doorgegeven in één aanvraag voor batchgewijze geocodering. Deze aanvraag wordt in een wachtrij geplaatst en doorgaans verwerkt in een paar minuten tot enkele uren, afhankelijk van de grootte van de gegevensset en de belasting van de service. Elk adres in de aanvraag heeft een transactie gegenereerd.

Azure Maps heeft een service voor batchgewijze geocodering, maar daarmee kunnen maximaal 10.000 adressen worden doorgegeven in één aanvraag. Afhankelijk van de grootte van de gegevensset en de belasting van de service wordt de aanvraag in enkele seconden tot minuten verwerkt. Elk adres in de aanvraag heeft een transactie gegenereerd.

Een andere optie voor het geocoderen van een groot aantal adressen met Azure Maps is door parallelle aanvragen te maken voor de standaard zoek-API's. Deze services accepteren slechts één adres per aanvraag, maar kunnen worden gebruikt in combinatie met de S0-categorie, die ook limieten voor vrij gebruik biedt. Met de categorie S0 kunnen vanuit één account maximaal 50 aanvragen per seconde naar het Azure Maps-platform worden verzonden. Dus als u deze limieten verwerkt om binnen die limiet te blijven, is het mogelijk om maximaal 180.000 adressen per uur te coderen. De prijscategorie Gen2 of Gen1 (S1) heeft geen gedocumenteerde limiet voor het aantal query's per seconde dat kan worden gemaakt van een account, zodat veel meer gegevens sneller kunnen worden verwerkt bij het gebruik van die prijscategorie, maar het gebruik van de batchgewijze geocoderingsservice helpt de totale hoeveelheid overgedragen gegevens te verminderen, waardoor het netwerkverkeer wordt verminderd.

Notitie

Buitengebruikstelling van Azure Kaarten Gen1-prijscategorie

De prijscategorie Gen1 is nu afgeschaft en wordt buiten gebruik gesteld op 15-9-26. De prijscategorie Gen2 vervangt Gen1 (zowel S0 als S1). Als voor uw Azure Kaarten-account een Gen1-prijscategorie is geselecteerd, kunt u overschakelen naar de Gen2-prijscategorie voordat deze buiten gebruik wordt gesteld, anders wordt deze automatisch bijgewerkt. Zie De prijscategorie van uw Azure Kaarten-account beheren voor meer informatie over de buitengebruikstelling van de Gen1-prijscategorie.

• Zoekadres ophalen: geocodering van vrije vorm wordt gebruikt om één adrestekenreeks (zoals "1 Microsoft way, Redmond, WA") op te geven en de aanvraag onmiddellijk te verwerken. Deze service wordt aanbevolen voor snelle geocodering van afzonderlijke adressen.
• Get Search Address Structured: Structured address geocoding wordt gebruikt om de onderdelen van één adres op te geven, zoals de straatnaam, plaats, land/regio en postcode en de aanvraag onmiddellijk verwerken. Deze service wordt aanbevolen voor snelle geocodering van afzonderlijke adressen die al zijn geparseerd in afzonderlijke adresonderdelen.
• Post Search Address Batch: Gebruik geocodering van batchadressen om een aanvraag te maken met maximaal 10.000 adressen en deze gedurende een bepaalde periode te laten verwerken. Alle adressen worden parallel op de server gecodeerd en wanneer de volledige resultatenset is voltooid, kan deze worden gedownload. Deze service wordt aanbevolen voor geocodering van grote gegevenssets.
• Zoek fuzzy ophalen: de fuzzy zoek-API combineert adresgeocodering met nuttige zoekacties. Deze API maakt gebruik van een vrije tekenreeks die een adres, plaats, oriëntatiepunt, nuttige plaats of nuttigeplaatscategorie kan zijn en verwerkt de aanvraag direct. Deze API wordt aanbevolen waarin gebruikers in hetzelfde tekstvak naar adressen of nuttige plaatsen kunnen zoeken.
• Post Search Fuzzy Batch: Gebruik de fuzzy batchzoekopdracht om een aanvraag te maken met maximaal 10.000 adressen, plaatsen, oriëntatiepunten of nuttige plaatsen en deze gedurende een bepaalde periode te laten verwerken. Alle gegevens worden parallel op de server verwerkt en wanneer de volledige resultatenset is voltooid, kunnen ze worden gedownload.

Gegevens over administratieve grenzen ophalen

In Bing Kaarten worden administratieve grenzen voor landen/regio's, staten, provincies, steden en postcodes beschikbaar gesteld via de Geodata-API. Deze API neemt een coördinaat of een query op voor geocodering. Als een query wordt doorgegeven, wordt deze geocodeerd en worden de coördinaten van het eerste resultaat gebruikt. Deze API neemt de coördinaten en haalt de grens op van het opgegeven entiteitstype dat de coördinaat kruist. Deze API heeft niet noodzakelijkerwijs de grens geretourneerd voor de query die is doorgegeven. Als een query "Seattle, WA" wordt doorgegeven, maar de waarde van het entiteitstype is ingesteld op land/regio, wordt de grens voor de VS geretourneerd.

Azure Kaarten biedt ook toegang tot administratieve grenzen (landen/regio's, staten, provincies, steden en postcodes). Als u een grens wilt ophalen, moet u een query uitvoeren op een van de zoek-API's voor de gewenste grens (zoals Seattle, WA). Als het zoekresultaat een bijbehorende grens heeft, wordt er een geometrie-id opgegeven in het resultaatantwoord. Vervolgens kan de API voor het zoeken naar veelhoeken worden gebruikt om de exacte grenzen voor een of meer geometrie-id's op te halen. Dit is iets anders dan in Bing Maps, omdat Azure Maps de grens retourneert voor wat er is doorzocht, terwijl Bing Maps een grens retourneert voor een opgegeven entiteitstype bij een opgegeven coördinaat. Daarnaast retourneert Azure Maps de grensgegevens in GeoJSON-indeling.

Even een samenvatting:

1. Geef een query door voor de grens die u wilt ontvangen in een van de volgende zoek-API's.

   • Zoekadres ophalen (vrije adresgeocodering)
   • Get Search Address Structured (structured address geocoding)
   • Post Search Address Batch (Batch address geocoding)
   • Post Search Fuzzy Batch (Fuzzy search)
   • Post Search Fuzzy Batch (Fuzzy batch search)

2. Als de gewenste resultaten een geometrie-id(s) hebben, geeft u deze door aan de Get Search Polygon-API .

Ruimtelijke bedrijfsgegevens hosten en opvragen

De services voor ruimtelijke gegevens in Bing Kaarten bieden eenvoudige oplossing voor ruimtelijke gegevensopslag voor het hosten van bedrijfsgegevens en het beschikbaar maken als een ruimtelijke REST-service. Deze service biedt vier hoofdquery's: zoeken op eigenschap, zoeken in de buurt, zoeken binnen begrenzingsvak en zoeken binnen 1 mijl van een route. Veel bedrijven die deze service gebruiken, hebben vaak al hun zakelijke gegevens opgeslagen in een database en een kleine subset ervan naar deze service geüpload om toepassingen, zoals zoekfuncties voor winkels, mogelijk te maken. Omdat verificatie op basis van sleutels basisbeveiliging biedt, is het raadzaam deze service alleen te gebruiken met openbare gegevens.

De meeste bedrijfslocatiegegevens beginnen in een database. Daarom is het raadzaam om bestaande Azure Storage-oplossingen zoals Azure SQL of Azure PostgreSQL te gebruiken (met de PostGIS-invoegtoepassing). Beide opslagoplossingen ondersteunen ruimtelijke gegevens en bieden een uitgebreide reeks mogelijkheden voor ruimtelijke query's. Zodra uw gegevens zich in een geschikte opslagoplossing bevinden, kunnen ze in uw toepassing worden geïntegreerd door een aangepaste webservice te maken of door een framework zoals ASP.NET of Entity Framework te gebruiken. Het gebruik van deze methode is veiliger en biedt meer querymogelijkheden.

Azure Cosmos DB biedt ook een beperkt aantal ruimtelijke mogelijkheden die, afhankelijk van uw scenario, mogelijk voldoende zijn.

Hier volgen enkele nuttige bronnen rond het hosten en opvragen van ruimtelijke gegevens in Azure.

• Overzicht van ruimtelijke gegevenstypen in Azure SQL
• Azure SQL Spatial – Dichtstbijzijnde buren opvragen
• Overzicht van georuimtelijke mogelijkheden in Azure Cosmos DB

Clientbibliotheken

Azure Maps biedt clientbibliotheken voor de volgende computertalen:

• JavaScript, TypeScript, Node.js - documentatie | npm-pakket

Opensource-clientbibliotheken voor andere programmeertalen:

• .NET Standard 2.0 – NuGet-pakket voor GitHub-project |

Resources opschonen

Er zijn geen resources om op te schonen.

Volgende stappen

Meer informatie over de REST-services van Azure Maps.

Aanbevolen procedures voor Azure Kaarten Search-service