Självstudie: Migrera webbtjänst från Bing Maps

Både Azure och Bing Maps ger åtkomst till rumsliga API:er via REST-webbtjänster. API-gränssnitten för dessa plattformar utför liknande funktioner men använder olika namngivningskonventioner och svarsobjekt. I den här självstudien får du lära dig hur man:

  • Framåtriktad och omvänd geokodning
  • Söka efter platser av intresse
  • Beräkna vägar och riktningar
  • Hämta en kartbild
  • Beräkna en avståndsmatris
  • Hämta tidszonsinformation

Följande tabell innehåller de API Azure Maps tjänst som tillhandahåller liknande funktioner som api:erna för Bing Maps-tjänsten.

Api för Bing Maps-tjänsten API för Azure Maps-tjänsten
Automatiska förslag Sök
Riktningar (inklusive lastbil) Vägriktningar
Avståndsmatris Ruttmatris
Bilder – statisk karta Rendering
Isokroner Ruttintervall
Lokala insikter Sök + Ruttintervall
Lokal sökning Sök
Platsigenkänning (POIs) Sök
Platser (framåt/omvänd geokodning) Sök
Fäst vid vägen ANVISNINGAR för POST-väg
Spatial Data Services (SDS) Sök + Route + andra Azure-tjänster
Tidszon Tidszon
Trafikincidenter Information om trafikincident
Höjd Höjd

Följande tjänst-API:er är för närvarande inte tillgängliga i Azure Maps:

  • Optimerade rutter – planerade. Azure Maps Route-API:et stöder optimering av försäljning av resor för ett enskilt fordon.
  • Bildmetadata – Används främst för att hämta panel-URL:er i Bing Maps. Azure Maps har en fristående tjänst för direkt åtkomst till kartpaneler.

Azure Maps har flera ytterligare REST-webbtjänster som kan vara av intresse.

  • Azure Maps Creator – Skapa en anpassad privat digital tvilling med byggnader och utrymmen.
  • Rumsliga åtgärder – Avlasta komplexa rumsliga beräkningar och åtgärder, till exempel geofencing, till en tjänst.
  • Kartpaneler – Få åtkomst till väg- och bildpaneler från Azure Maps som panel och vektorpaneler.
  • Batch-routning – Tillåter att upp till 1 000 routningsbegäranden görs i en enda batch under en viss tidsperiod. Vägar beräknas parallellt på servern för snabbare bearbetning.
  • Trafik Flow – Få åtkomst till trafikflödesdata i realtid som både miner- och vektorpaneler.
  • Geoplats-API (förhandsversion) – Hämta platsen för en IP-adress.
  • Vädertjänster – Få åtkomst till väderdata i realtid och väderprognoser.

Läs även igenom följande riktlinjer för bästa praxis:

Förutsättningar

  1. Logga in på Azure-portalen. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.
  2. Skapa ett Azure Maps konto
  3. Skaffa en primär prenumerationsnyckel, som även kallas primärnyckel eller prenumerationsnyckel. Mer information om autentisering i Azure Maps finns i Hantera autentisering i Azure Maps.

Geokodningsadresser

Geokodning är en process för att konvertera en adress (till exempel ) till en koordinat (till exempel "1 Microsoft way, Redmond, WA" longitud: -122.1298, latitud: 47.64005). Koordinater används sedan ofta för att placera en kartnål på en karta eller centrera en karta.

Azure Maps flera metoder för geokodningsadresser.

  • Geokodning av friformsadress:Ange en enskild adresssträng (till exempel "1 Microsoft way, Redmond, WA" ) och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt.
  • Strukturerad adressgeokodning:Ange delarna i en enskild adress, till exempel gatunamn, ort, land och postnummer och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt och data redan parsas till dess enskilda adressdelar.
  • Geokodning av Batch-adress:Skapa en begäran som innehåller upp till 10 000 adresser och få dem bearbetade under en viss tidsperiod. Alla adresser geokodas parallellt på servern och när den är klar kan den fullständiga resultatuppsättningen laddas ned. Den här tjänsten rekommenderas för geokodning av stora datamängder.
  • Fuzzy-sökning:Det här API:et kombinerar adressgeokodning med sökning efter platser av intresse. Det här API:et tar en sträng i fritt format som kan vara en adress, plats, landmärke, punkt av intresse eller en intressepunktskategori och bearbeta begäran omedelbart. Det här API:et rekommenderas för program där användare kan söka efter adresser eller platser av intresse från samma textruta.
  • Fuzzy-batchsökning:Skapa en begäran som innehåller upp till 10 000 adresser, platser, landmärken eller intressen och få dem bearbetade under en viss tidsperiod. Alla data bearbetas parallellt på servern och när den är klar kan den fullständiga resultatuppsättningen laddas ned.

Följande tabeller korsreferenser till API-parametrarna för Bing Maps med jämförbara API-parametrar i Azure Maps för strukturerad och friforms-adress-geokodning.

Plats efter adress (strukturerad adress)

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
addressLine streetNumber, streetName eller crossStreet
adminDistrict countrySubdivision
countryRegion country och countryCode
locality municipality eller municipalitySubdivision
postalCode postalCode
maxResults (maxRes) limit
includeNeighborhood (inclnb) Ej tillgängligt – Returneras alltid av Azure Maps om tillgängligt.
include (incl) Ej a– ISO2-landskod returneras alltid av Azure Maps.
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Azure Maps också stöd för;

  • countrySecondarySubdivision – County, distrikt
  • countryTertiarySubdivision – Namngivna områden; gens, cantons, mens
  • ofs – Bläddra igenom resultaten i kombination med maxResults parameter.

Plats efter fråga (friformsadresssträng)

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
query query
maxResults (maxRes) limit
includeNeighborhood (inclnb) Ej tillgängligt – Returneras alltid av Azure Maps om tillgängligt.
include (incl) Ej a – Iso2-landskod returneras alltid av Azure Maps.
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Azure Maps också stöd för;

  • typeahead – Art om frågan tolkas som en partiell indata och sökningen går in i förutsägelseläge (automatiska förslag/komplettera automatiskt).
  • countrySet – En kommaavgränsad lista över ISO2-länders koder som sökningen ska begränsas till.
  • lat/lon, topLeft / btmRight , – radius Ange användarens plats och område för att göra resultatet mer lokalt relevant.
  • ofs – Bläddra igenom resultaten i kombination med maxResults parametern .

Ett exempel på hur du använder söktjänsten finns dokumenterat här. Läs igenom metodtipsen för sökdokumentation.

Omvänd geokodning av en koordinat (Hitta en plats efter punkt)

Omvänd geokodning är en process för att konvertera geografiska koordinater (till exempel longitud: -122.1298, latitud: 47.64005) till dess ungefärliga adress (t.ex. "1 Microsoft way, Redmond, WA" ).

Azure Maps tillhandahåller flera omvända geokodningsmetoder.

  • Adress för omvänd geokodare:Ange en enda geografisk koordinat för att hämta dess ungefärliga adress och bearbeta begäran omedelbart.
  • Omvänd geokodare mellangator: Ange en enda geografisk koordinat för att hämta information om närliggande gatukorsning (till exempel 1:a & huvudnamn) och bearbeta begäran omedelbart.
  • Omvänd geokodare förBatch-adress: Skapa en begäran som innehåller upp till 10 000 koordinater och bearbeta dem under en viss tidsperiod. Alla data bearbetas parallellt på servern och när du är klar kan den fullständiga resultatuppsättningen laddas ned.

Följande tabell korsreferenser till BING Maps API-parametrarna med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
point query
includeEntityTypes entityType – Se jämförelsetabellen för entitetstyp nedan.
includeNeighborhood (inclnb) Ej tillgängligt – Returneras alltid av Azure Maps om tillgängligt.
include (incl) Ej a – Iso2-landskod returneras alltid av Azure Maps.
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Läs igenom metodtipsen för sökdokumentation.

API:Azure Maps för omvänd geokodning har vissa ytterligare funktioner som inte är tillgängliga i Bing Maps som kan vara användbara att integrera när du migrerar din app:

  • Hämta hastighetsbegränsningsdata.
  • Hämta information om väganvändning; lokal väg, pulsslag, begränsad åtkomst, ramp osv.
  • På sidan av gatuadressen hamnar koordinaten på.

Jämförelsetabell för entitetstyp

I följande tabell korsreferenser värdena för entitetstyp i Bing Maps till motsvarande egenskapsnamn i Azure Maps.

Entitetstyp i Bing Maps Jämförbar Azure Maps entitetstyp Beskrivning
Address Adress
Neighborhood Neighbourhood Kvarter
PopulatedPlace Municipality eller MunicipalitySubdivision Stad, Stad eller Sub eller Super City
Postcode1 PostalCodeArea Postnummer eller postnummer
AdminDivision1 CountrySubdivision Delstat eller provins
AdminDivision2 CountrySecondarySubdivison Countyn eller distrikt
CountryRegion Country Landsnamn
CountryTertiarySubdivision Gens, Cantons, Etorer

Hämta platsförslag (automatiska förslag)

Flera av Azure Maps api:et har stöd för förutsägelseläge som kan användas för scenarier med automatiska förslag. Api:Azure Maps för fuzzy-sökning är mest likt API:et för automatiska förslag i Bing Maps. Följande API har även stöd för förutsägelseläge, lägg &typeahead=true till i frågan:

  • Geokodning av friformsadress:Ange en enda adresssträng (till exempel "1 Microsoft way, Redmond, WA" ) och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt.
  • Fuzzy-sökning:Det här API:et kombinerar adressgeokodning med punkt-av-intresse-sökning. Det här API:et tar en friformssträng som kan vara en adress, plats, landmärke, punkt av intresse eller en intressepunktskategori och bearbetar begäran omedelbart. Det här API:et rekommenderas för program där användare kan söka efter adresser eller platser av intresse från samma textruta.
  • POI-sökning:Sök efter intressanta platser efter namn. Till exempel; "starbucks".
  • Sökning efter POI-kategori:Sök efter intressanta platser efter kategori. Till exempel; "restaurang".

Beräkna vägar och riktningar

Azure Maps kan användas för att beräkna vägar och riktningar. Azure Maps har många av samma funktioner som Bing Maps-routningstjänsten, till exempel;

  • ankomst- och avgångstider
  • trafikvägar i realtid och förutsägelsebaserad trafik
  • olika transportlägen; driving, walking, truck
  • orderoptimering för waypoint (resa säljare)

Anteckning

Azure Maps kräver att alla waypoints ska vara koordinater. Adresser måste geokodas först.

Tjänsten Azure Maps tillhandahåller följande API:er för att beräkna vägar:

  • Beräkna väg:Beräkna en väg och bearbeta begäran omedelbart. Det här API:et stöder både GET- och POST-begäranden. POST-begäranden rekommenderas när du anger ett stort antal vägpunkter eller när du använder många vägalternativ för att säkerställa att URL-begäran inte blir för lång och orsakar problem.
  • Batch-väg:Skapa en begäran som innehåller upp till 1 000 vägbegäran och bearbeta dem under en viss tidsperiod. Alla data bearbetas parallellt på servern och när du är klar kan den fullständiga resultatuppsättningen laddas ned.

Följande tabell korsreferenser till BING Maps API-parametrarna med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
avoid avoid
dateTime (dt) departAt eller arriveAt
distanceBeforeFirstTurn (dbft) Ej tillämpligt
distanceUnit (du) Ej a– Azure Maps använder endast måttsystemet.
heading (hd) vehicleHeading
maxSolutions (maxSolns) maxAlternatives, alternativeType minDeviationDistance , och minDeviationTime
optimize (optwz) routeType och traffic
optimizeWaypoints (optWp) computeBestOrder
routeAttributes (ra) instructionsType
routePathOutput (rpo) routeRepresentation
timeType (tt) departAt eller arriveAt
tolerances (tl) Ej tillämpligt
travelMode travelMode
waypoint.n ( wp.n ) eller viaWaypoint.n (vwp.n) query – koordinater i formatet lat0,lon0:lat1,lon1….
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Api:et Azure Maps också stöd för lastbilsdirigering inom samma API. Följande tabell korsreferenser till de ytterligare parametrarna för lastbilsdirigering i Bing Maps med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
dimensionUnit (dims) Ej a– Dimensioner i mätare stöds endast.
weightUnit (wu) Ej tillgänglig – Vikter i kg stöds endast.
vehicleHeight (height) vehicleHeight
vehicleWidth (width) vehicleWidth
vehicleLength (vl) vehicleLength
vehicleWeight (weight) vehicleWeight
vehicleAxles (axles) vehicleAxelWeight
vehicleTrailers (vt) Ej A
vehicleSemi (semi) vehicleCommercial
vehicleMaxGradient (vmg) Ej A
vehicleMinTurnRadius (vmtr) Ej A
vehicleAvoidCrossWind (vacw) Ej a-A
vehicleAvoidGroundingRisk (vagr) Ej a-A
vehicleHazardousMaterials (vhm) vehicleLoadType
vehicleHazardousPermits (vhp) vehicleLoadType

Tips

Som standard returnerar Azure Maps väg-API endast en sammanfattning (avstånd och tider) och koordinaterna för vägsökvägen. Använd instructionsType parametern för att hämta turn-by-turn-instruktioner. Parametern routeRepresentation kan användas för att filtrera bort sammanfattnings- och vägsökvägen.

Läs även Metodtips för routningsdokumentation.

API:Azure Maps har många ytterligare funktioner som inte är tillgängliga i Bing Maps och som kan vara användbara att integrera när du migrerar din app:

  • Stöd för vägtyp: kortaste, snabbaste, drilling och mest bränsleeffektivt.
  • Stöd för ytterligare färdlägen: cykel, buss, motorcykel, taxi, lastbil och van.
  • Stöd för 150 waypoints.
  • Beräkna flera restider i en enskild begäran. historisk trafik, direkttrafik, ingen trafik.
  • Undvik ytterligare vägtyper: bilpoolvägar, ej indelade vägar, redan använda vägar.
  • Motorspecifik specifikationsbaserad routning. Beräkna rutter för elfordon eller elfordon baserat på återstående bränsle-/avgiftsspecifikationer och motorspecifikationer.
  • Ange högsta fordonshastighet.

Fäst koordinaterna på vägen

Det finns flera sätt att fästa koordinater på vägar i Azure Maps.

  • Använd API:et för vägriktningar för att fästa koordinaterna till en logisk väg längs vägnätverket.
  • Använd Azure Maps Web SDK för att fästa enskilda koordinater till närmaste väg i vektorpanelerna.
  • Använd panelerna Azure Maps vektor direkt för att fästa enskilda koordinater.

Använda vägriktnings-API:et för att fästa koordinater

Azure Maps kan fästa koordinater på vägar med hjälp av API:et för vägriktningar. Den här tjänsten kan användas för att rekonstruera en logisk väg mellan en uppsättning koordinater och är jämförbar med API:et fäst vid väg i Bing Maps.

Det finns två olika sätt att använda API:et för vägriktningar för att fästa koordinaterna på vägar.

  • Om det finns 150 koordinater eller mindre kan de skickas som waypoints i API:et för GET-vägriktningar. Med den här metoden kan två olika typer av fästa data hämtas: väginstruktioner innehåller enskilda fästa waypoints, medan vägvägen har en interpolerad uppsättning koordinater som fyller den fullständiga sökvägen mellan koordinaterna.
  • Om det finns fler än 150 koordinater kan API:et för POST-vägriktningar användas. Koordinaterna för start och slut måste skickas till frågeparametern, men alla koordinater kan skickas till parametern i brödtexten i POST-begäran och formatera en GeoJSON-geometrisamling med supportingPoints punkter. De enda fästa data som är tillgängliga med den här metoden är den vägväg som är en interpolerad uppsättning koordinater som fyller den fullständiga sökvägen mellan koordinaterna. Här är ett exempel på den här metoden med hjälp av tjänstmodulen i Azure Maps Web SDK.

Följande tabell korsreferenser till API-parametrarna för Bing Maps med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
points supportingPoints – skicka dessa punkter i brödtexten i postbegäran
interpolate Saknas
includeSpeedLimit Saknas
includeTruckSpeedLimit Saknas
speedUnit Saknas
travelMode travelMode
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Api:et Azure Maps också stöd för lastbilsdirigeringsparameter i samma API för att säkerställa att logiska sökvägar beräknas. Följande tabell korsreferenser till de ytterligare parametrarna för Bing Maps-lastbilsdirigering med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
dimensionUnit (dims) Ej a– dimensioner i mätare stöds endast.
weightUnit (wu) Ej a– vikter i kg stöds endast.
vehicleHeight (height) vehicleHeight
vehicleWidth (width) vehicleWidth
vehicleLength (vl) vehicleLength
vehicleWeight (weight) vehicleWeight
vehicleAxles (axles) vehicleAxelWeight
vehicleTrailers (vt) Ej a-A
vehicleSemi (semi) vehicleCommercial
vehicleMaxGradient (vmg) Ej a-A
vehicleMinTurnRadius (vmtr) Ej a-A
vehicleAvoidCrossWind (vacw) Ej a-A
vehicleAvoidGroundingRisk (vagr) Ej a-A
vehicleHazardousMaterials (vhm) vehicleLoadType
vehicleHazardousPermits (vhp) vehicleLoadType

Eftersom den här metoden använder API:et för vägriktningar kan den fullständiga uppsättningen alternativ i tjänsten användas för att anpassa logiken som används för att fästa koordinaten på vägar. Om du till exempel anger en avgångstid skulle det leda till att historiska trafikdata beaktas.

API:Azure Maps vägriktningar returnerar för närvarande inte hastighetsbegränsningsdata, men det kan hämtas med hjälp Azure Maps api:et för omvänd geokodning.

Använda Webb-SDK för att fästa koordinater

I Azure Maps Web SDK används vektorpaneler för att rendera kartorna. Dessa vektorpaneler innehåller den råa informationen om väggeometrin och kan användas för att beräkna den närmaste vägen till en koordinat för enkel tak av enskilda koordinater. Detta är användbart när du vill att koordinaterna ska visas visuellt över vägar och du redan använder Azure Maps Web SDK för att visualisera data.

Den här metoden fästs dock bara vid de vägsegment som läses in i kartvyn. När du zoomar ut på landsnivå kanske det inte finns några vägdata, så det går inte att fästa, men på den zoomnivån kan en enda bildpunkt representera området i flera stadsblock, så du behöver inte fästa. För att åtgärda detta kan fästlogiken tillämpas varje gång kartan har flyttats. Här är ett kodexempel som visar detta.

Använda Azure Maps vektorpaneler direkt till fästkoordinater

Panelerna Azure Maps vektor innehåller rådata för väggeometri som kan användas för att beräkna den närmaste punkten på en väg till en koordinat för att göra grundläggande tak av enskilda koordinater. Alla vägsegment visas i sektorerna på zoomnivå 15, så du bör hämta paneler därifrån. Du kan sedan använda pyramiden i quadtree för att avgöra om panelerna behövs och konvertera panelerna till geometrier. Därifrån kan ett rumsligt matematikbibliotek, till exempel js eller NetTopologySuite, användas för att beräkna de närmaste linjesegmenten.

Hämta en kartbild (statisk karta)

Azure Maps ett API för att återge statiska kartbilder med överlagrade data. API:et Azure Maps map-bildåtergivning är jämförbart med API:et för statisk karta i Bing Maps.

Anteckning

Azure Maps kräver att mitten, alla kartnålar och sökvägsplatser ska vara koordinater i longitude,latitude formatet medan Bing Maps använder latitude,longitude formatet.

Adresser måste geokodas först.

Följande tabell korsreferenser till API-parametrarna för Bing Maps med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
centerPoint center
format format – anges som en del av URL-sökvägen. För närvarande stöds endast PNG.
heading Ej a– Gatusidan stöds inte.
imagerySet layer och style – Se dokumentation om mappningsformat som stöds.
mapArea (ma) bbox
mapLayer (ml) Ej tillämpligt
mapSize (ms) width och height – kan vara upp till 8192 x 8192 i storlek.
declutterPins (dcl) Saknas
dpi Saknas
drawCurve path
mapMetadata Saknas
pitch Ej a– Gatusidan stöds inte.
pushpin (pp) pins
zoomLevel zoom
query Ej a– mitterst eller begränsningsruta måste användas.
highlightEntity (he) Saknas
style Saknas
vägparametrar Ej tillämpligt
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Anteckning

Azure Maps använder ett panelsystem med paneler som är dubbelt så stora som kartpanelerna som används i Bing Maps. Därför visas zoomnivåvärdet i Azure Maps en zoomningsnivå närmare i Azure Maps jämfört med Bing Maps. Sänk zoomnivån i de begäranden som du migrerar med 1 för att kompensera för detta.

Mer information finns i i guiden om renderings-API:et för kartbilden.

Förutom att kunna generera en statisk kartbild ger Azure Maps-renderingstjänsten även möjlighet att direkt komma åt kartpaneler i png-format (textanalys) och vektorformat.

  • Kartpanel – Hämta png-paneler (raster) och vektorpaneler för baskartor (vägar, gränser, bakgrund).
  • Kartbildpanel – Hämta paneler för flygfoton och satellitbilder.

Jämförelse av URL-parameterformat för kartnål

Före: Bing Maps

I Bing Maps kan kartnålar läggas till i en statisk kartbild med hjälp av pushpin parametern i URL:en. Parametern pushpin tar en plats i latitude,longitude format, ett ikonformat och en textetikett (upp till tre tecken) enligt nedan:

&pushpin=latitude,longitude;iconStyle;label

Ytterligare kartnålar kan läggas till genom att lägga pushpin till ytterligare parametrar i URL:en med en annan uppsättning värden. Formaten för kartnålsikoner är begränsade till ett av de fördefinierade format som är tillgängliga i Bing Maps-API:et.

I Bing Maps kan till exempel en röd kartnål med etiketten "AB" läggas till på kartan vid koordinaterna (longitud: -110, latitud: 45) med följande URL-parameter:

&pushpin=45,-110;7;AB

Kartnål för statiska Bing-kartor

Efter: Azure Maps

I Azure Maps kan kartnålar också läggas till i en statisk kartbild genom att ange pins parametern i URL:en. Kartnålar i Azure Maps definieras genom att ange ett ikonformat och en lista över platser som använder det ikonformatet. Den här informationen skickas sedan till pins parametern kan anges flera gånger för att stödja kartnålar med olika format.

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

Du kan använda fler format genom att lägga till ytterligare parametrar i pins URL:en med ett annat format och en annan uppsättning platser.

När det gäller att fästa platser Azure Maps koordinaterna vara i formatet medan longitude latitude Bing Maps använder latitude,longitude format. Observera också att det finns ett blanksteg, inte ett kommaavgränsande longitud och latitud i Azure Maps.

Värdet iconType anger vilken typ av PIN-kod som ska skapas och kan ha följande värden:

  • default – Standardikonen för pin-kod.
  • none – Ingen ikon visas, endast etiketter återges.
  • custom – Anger att en anpassad ikon ska användas. En URL som pekar på ikonbilden kan läggas till i slutet av pins parametern efter fästplatsinformationen.
  • {udid} – Ett unikt data-ID (UDID) för en ikon som lagras Azure Maps Data Storage-plattformen.

Fästformat i Azure Maps läggs till med formatet , med flera format optionNameValue avgränsade med pipe ( | ) tecken som detta iconType|optionName1Value1|optionName2Value2 . Observera att alternativnamnen och värdena inte är avgränsade. Följande formatalternativnamn kan användas för att formatera kartnålar i Azure Maps:

  • al – Anger opaciteten (alfa) för kartnålarna. Kan vara ett tal mellan 0 och 1.
  • an – Anger fästpunkt. X- och y-pixelvärden som anges i formatet x y .
  • co – Stiftfärgen. Måste vara en 24-bitars hexadexfärg: 000000 till FFFFFF .
  • la – Anger etikettankare. X- och y-pixelvärden som anges i formatet x y .
  • lc – Etikettens färg. Måste vara en 24-men hexadexfärg: 000000 till FFFFFF .
  • ls – Etikettens storlek i bildpunkter. Kan vara ett tal som är större än 0.
  • ro – Ett värde i grader för att rotera ikonen. Kan vara ett tal mellan -360 och 360.
  • sc – Ett skalningsvärde för fästikonen. Kan vara ett tal som är större än 0.

Etikettvärden anges för varje stiftplats i stället för att ha ett enda etikettvärde som gäller för alla kartnålar i listan över platser. Etikettvärdet kan vara en sträng med flera tecken och vara omslutet med enkla citattecken för att säkerställa att det inte av misstag används som ett format- eller platsvärde.

I Azure Maps kan du till exempel lägga till en röd ( ) standardikon med etiketten FF0000 "Space Needle" placerad nedan (15 50) ikonen vid koordinaterna (longitud: -122.349300, latitud: 47.620180) med följande URL-parameter:

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

Azure Maps statisk kartnål

I följande exempel läggs tre stift till med etikettvärdena "1", "2" och "3":

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

Azure Maps statisk karta med flera stift

Jämförelse av format för URL-parameter för ritad kurva

Före: Bing Maps

I Bing kan du lägga till linjer och polygoner i en statisk kartbild med hjälp av drawCurve parametern i URL:en. Parametern tar en formtyp, en formattyp och en lista över platser som drawCurve ska återges på kartan enligt nedan:

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

Du kan använda fler format genom att lägga till ytterligare parametrar i drawCurve URL:en med ett annat format och en annan uppsättning platser.

Platser i Bing Maps anges med formatet latitude1,longitude1_latitude2,longitude2_… . Platser kan också kodas.

Formtyper i Bing Maps innehåller linjer, polygoner, cirkel och kurva. Stiltyper omfattar linjefärg, linjetjocklek, konturfärg, fyllningsfärg, konturtjocklek och cirkulär radie.

I Bing Maps kan till exempel en blå linje med 50 % opacitet och en tjocklek på fyra bildpunkter läggas till i kartan mellan koordinaterna (longitud: -110, latitud: 45 och longitud: -100, latitud: 50) med följande URL-parameter:

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

Statisk kartlinje i Bing Maps

Efter: Azure Maps

I Azure Maps kan även linjer och polygoner läggas till i en statisk kartbild genom att ange sökvägsparametern i URL:en. Precis som Bing Maps kan ett format och en lista över platser anges i den här parametern, och parametern path kan anges flera gånger för att rendera flera cirklar, linjer och polygoner med olika format.

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

När det gäller sökvägsplatser kräver Azure Maps koordinaterna vara i longitude latitude format medan Bing Maps använder latitude,longitude format. Observera också att det finns ett blanksteg, inte ett kommaavgränsande longitud och latitud i Azure Maps. Azure Maps stöder för närvarande inte kodade sökvägar. Större datamängder kan laddas upp som en GeoJSON-fil som fylls i Azure Maps Data Storage-API enligt dokumentationen här.

Sökvägsformat i Azure Maps läggs till med formatet , med flera format optionNameValue avgränsade med pipe ( | ) tecken som detta optionName1Value1|optionName2Value2 . Observera att alternativnamnen och värdena inte är avgränsade. Följande formatalternativnamn kan användas för att formatera sökvägar i Azure Maps:

  • fa – Fyllningsfärgens opacitet (alfa) som används vid återgivning av polygoner. Kan vara ett tal mellan 0 och 1.
  • fc – Fyllningsfärgen som används för att rendera området för en polygon.
  • la – Den ogenomskinlighet för linjefärg (alfa) som används vid rendering av linjer och konturen av polygoner. Kan vara ett tal mellan 0 och 1.
  • lc – Linjefärgen som används för att återge linjer och konturen av polygoner.
  • lw – Bredden på linjen i bildpunkter.
  • ra – Anger en radie för cirklar i meter.

I Azure Maps kan till exempel en blå linje med 50 % opacitet och en tjocklek på fyra bildpunkter läggas till i kartan mellan koordinaterna (longitud: -110, latitud: 45 och longitud: -100, latitud: 50) med följande URL-parameter:

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

Azure Maps statisk kartlinje

Beräkna en avståndsmatris

Azure Maps ett API för att beräkna restider och avstånd mellan en uppsättning platser som en avståndsmatris. API:et Azure Maps avståndsmatrisen är jämförbar med API:et för avståndsmatris i Bing Maps.

  • Vägmatris:Asynkront beräknar restider och avstånd för en uppsättning ursprung och mål. Upp till 700 celler per begäran stöds (antalet ursprung multiplicerat med antalet mål). Med den begränsningen i åtanke är exempel på möjliga matrisdimensioner: 700x1 , , , , 50x10 10x10 28x25 10x70 .

Anteckning

En begäran till API:et för avståndsmatrisen kan bara göras med hjälp av en POST-begäran med ursprungs- och målinformationen i begärandetexten.

Dessutom kräver Azure Maps att alla ursprung och mål är koordinater. Adresser måste geokodas först.

Följande tabell korsreferenser till BING Maps API-parametrarna med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
origins origins – ange i POST-begärandetexten som GeoJSON.
destinations destination – ange i POST-begärandetexten som GeoJSON.
endTime arriveAt
startTime departAt
travelMode travelMode
resolution Ej tillämpligt
distanceUnit Ej a – alla avstånd i meter.
timeUnit Ej a– Alla gånger i sekunder.
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Tips

Alla avancerade routningsalternativ som är tillgängliga Azure Maps-API:et för routning (lastbilsroutning, motorspecifikationer, undvik...) har stöd i API:et för Azure Maps avståndsmatris.

Beräkna en isochrone

Azure Maps ett API för beräkning av en isokron, en polygon som täcker ett område som kan färdas till i valfri riktning från en ursprungspunkt inom en angiven tid eller mängd bränsle/avgifter. Det Azure Maps vägintervall-API:et är jämförbart med isochrone-API:et i Bing Maps.

  • Väg Intervall**: Beräkna en polygon som täcker ett område som kan tas i valfri riktning från en ursprungspunkt inom en angiven mängd tid, avstånd eller mängden bränsle/avgift som är tillgänglig.

Anteckning

Azure Maps kräver att frågans ursprung är en koordinat. Adresser måste geokodas först.

Bing Maps kan också beräkna isokroner baserat på tid eller avstånd, medan Azure Maps kan beräkna isokroner baserat på tid, avstånd eller mängden bränsle/avgift som är tillgänglig.

Följande tabell korsreferenser till BING Maps API-parametrarna med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
waypoint (wp) query
dateTime (dt) departAt
maxTime timeBudgetInSec
timeUnit (tu) Ej a– Alla gånger i sekunder.
travelMode (mode) travelMode
maxDistance (maxDis) distanceBudgetInMeters
distanceUnit (du) Ej a – alla avstånd i meter.
optimize (optmz) routeType
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Tips

Alla avancerade routningsalternativ som är tillgängliga Azure Maps-API:et för routning (lastbilsroutning, motorspecifikationer, undvik...) har stöd i Azure Maps isochrone-API:et.

Söka efter platser av intresse

Du kan söka efter point of interest-data i Bing Maps med hjälp av följande API:er:

  • Lokal sökning: Söker efter platser av intresse som finns i närheten (radiell sökning), efter namn eller entitetstyp (kategori). Api:erna Azure Maps POI-sökning och POI-kategori är mest lika det här API:et.
  • Platsigenkänning: Söker efter intressanta platser inom ett visst avstånd från en plats. Sök-API:Azure Maps i närheten liknar det här API:et.
  • Lokala insikter: Söker efter intressanta platser inom en angiven maximal körtid eller avstånd från en specifik koordinat. Detta kan uppnås med hjälp Azure Maps först beräkna en isochrone och sedan skicka den till sökningen inom geometri-API:et.

Azure Maps innehåller flera sök-API:er för platser av intresse:

  • POI-sökning:Sök efter intressanta platser efter namn. Till exempel; "starbucks".
  • Sökning efter POI-kategori:Sök efter intressanta platser efter kategori. Till exempel; "restaurang".
  • Sökning i närheten:Söker efter intressanta platser inom ett visst avstånd från en plats.
  • Fuzzy-sökning:Det här API:et kombinerar adressgeokodning med punkt-av-intresse-sökning. Det här API:et tar en friformssträng som kan vara en adress, plats, landmärke, punkt av intresse eller en intressepunktskategori och bearbetar begäran omedelbart. Det här API:et rekommenderas för program där användare kan söka efter adresser eller platser av intresse från samma textruta.
  • Sök inom geometri:Sök efter intressanta platser inom en angiven geometri (polygon).
  • Sök längs vägen:Sök efter intressanta platser längs en angiven vägväg.
  • Fuzzy-batchsökning:Skapa en begäran som innehåller upp till 10 000 adresser, platser, landmärken eller intressanta platser och bearbeta dem under en viss tidsperiod. Alla data bearbetas parallellt på servern och när du är klar kan den fullständiga resultatuppsättningen laddas ned.

Läs igenom metodtipsen för sökdokumentation.

Hämta trafikincidenter

Azure Maps flera API:er för att hämta trafikdata. Det finns två typer av trafikdata:

  • Flödesdata – ger mätvärden om trafikflödet på vägavsnitt. Detta används ofta för att färgkoda vägar. Dessa data uppdateras varannan minut.
  • Incidentdata – tillhandahåller data om konstruktion, vägstängning, olyckor och andra incidenter som kan påverka trafiken. Dessa data uppdateras varje minut.

Bing Maps tillhandahåller trafikflödes- och incidentdata i sina interaktiva kartkontroller och gör även incidentdata tillgängliga som en tjänst.

Trafikdata är också integrerade i de Azure Maps interaktiva kartkontrollerna. Azure Maps tillhandahåller också följande trafiktjänst-API:er:

  • Trafikflödessegment:Ger information om hastigheterna och restiderna för vägfragmentet närmast de angivna koordinaterna.
  • Trafikflödespaneler:Tillhandahåller paneler för textrutor och vektorer som innehåller trafikflödesdata. Dessa kan användas med de Azure Maps-kontrollerna eller i kartkontroller från tredje part, till exempel På vilket sätt. Vektorpanelerna kan också användas för avancerad dataanalys.
  • Information om trafikincident:Innehåller information om trafikincidenter inom en begränsningsruta, zoomningsnivå och trafikmodell.
  • Paneler för trafikincident:Tillhandahåller paneler för raster och vektorer som innehåller trafikincidentdata.
  • Vyport för trafikincident:Hämtar den juridiska och tekniska informationen för visningsområdet som beskrivs i begäran, till exempel trafikmodell-ID.

Följande tabell korsreferenser till API-parametrarna för Bing Maps-trafik med api-parametrarna för jämförbar information om trafikincident i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
mapArea boundingBox och boundingZoom
includeLocationCodes Ej tillämpligt
severity (s) Saknas – alla data som returneras
type (t) Saknas – alla data som returneras
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Hämta en tidszon

Azure Maps ett API för att hämta tidszonen som en koordinat finns i. Den Azure Maps tidszons-API:et är jämförbart med tidszons-API:et i Bing Maps.

Följande tabell korsreferenser till BING Maps API-parametrarna med jämförbara API-parametrar i Azure Maps.

API-parameter för Bing Maps Jämförbar Azure Maps API-parameter
point query
query Ej a– platser måste geokodas först.
dateTime timeStamp
includeDstRules Ej a– Ingår alltid i svar av Azure Maps.
key subscription-key – Se även dokumentationen om autentisering Azure Maps autentisering.
culture (c) language – Se dokumentation om språk som stöds.
userRegion (ur) view – Se dokumentation om vyer som stöds.

Utöver detta tillhandahåller Azure Maps också ett antal ytterligare tidszons-API:er som hjälper till med konverteringar med tidszonsnamn och -ID:er.

Spatial Data Services (SDS)

Rumsliga datatjänster i Bing Maps har tre viktiga funktioner:

  • Batch-geokodning – Bearbeta en stor batch med adressgeokoder med en enskild begäran.
  • Hämta administrativa gränsdata – Använd en koordinat och få en mellangräns för en angiven entitetstyp.
  • Vara värd för och fråga rumsliga affärsdata – Ladda upp en enkel 2D-tabell med data och få åtkomst till dem med några enkla rumsliga frågor.

Batch-geokoda data

Batch-geokodning är en process för att ta ett stort antal adresser eller platser, skicka dem i en enda begäran till en tjänst och få alla geokodade parallellt och resultatet returneras i ett enda svar.

Med Bing Maps kan upp till 200 000 adresser skickas i en enda batch-geokodningsbegäran. Den här begäran hamnar i en kö och bearbetar vanligtvis under en viss tidsperiod, allt från några minuter till några timmar beroende på storleken på datauppsättningen och belastningen på tjänsten. Varje adress i begäran genererade en transaktion.

Azure Maps har en batch-geokodningstjänst, men det gör att upp till 10 000 adresser kan skickas i en enda begäran och bearbetas över några sekunder till några minuter beroende på storleken på datauppsättningen och belastningen på tjänsten. Varje adress i begäran genererade en transaktion. I Azure Maps är batch-geokodningstjänsten endast tillgänglig för prisnivån Gen 2 eller S1. Mer information om prisnivåer finns i Välja rätt prisnivå i Azure Maps.

Ett annat alternativ för geokodning av ett stort antal adresser med Azure Maps är att göra parallella begäranden till standardsök-API:erna. Dessa tjänster accepterar bara en enda adress per begäran, men kan användas med S0-nivån som också tillhandahåller kostnadsfria användningsgränser. S0-nivån tillåter upp till 50 begäranden per sekund till Azure Maps plattform från ett enda konto. Så om du bearbetar begränsningen för att hålla gränsen inom den gränsen kan du geokoda upp till 180 000 adresser i timmen. Prisnivån Gen 2 eller S1 har ingen dokumenterad gräns för antalet frågor per sekund som kan göras från ett konto, så mycket mer data kan bearbetas snabbare när du använder den prisnivån, men med batch-geokodningstjänsten kan du minska den totala mängden data som överförs och drastiskt minska nätverkstrafiken.

  • Geokodning av friformsadress:Ange en enskild adresssträng (till exempel "1 Microsoft way, Redmond, WA" ) och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt.
  • Strukturerad adressgeokodning:Ange delarna i en enskild adress, till exempel gatunamn, ort, land och postnummer och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt och data redan parsas till dess enskilda adressdelar.
  • Geokodning av Batch-adress:Skapa en begäran som innehåller upp till 10 000 adresser och få dem bearbetade under en viss tidsperiod. Alla adresser geokodas parallellt på servern och när den är klar kan den fullständiga resultatuppsättningen laddas ned. Den här tjänsten rekommenderas för geokodning av stora datamängder.
  • Fuzzy-sökning:Det här API:et kombinerar adressgeokodning med sökning efter platser av intresse. Det här API:et tar en sträng i fritt format som kan vara en adress, plats, landmärke, punkt av intresse eller en intressepunktskategori och bearbeta begäran omedelbart. Det här API:et rekommenderas för program där användare kan söka efter adresser eller platser av intresse från samma textruta.
  • Fuzzy-batchsökning:Skapa en begäran som innehåller upp till 10 000 adresser, platser, landmärken eller intressen och få dem bearbetade under en viss tidsperiod. Alla data bearbetas parallellt på servern och när den är klar kan den fullständiga resultatuppsättningen laddas ned.

Hämta administrativa gränsdata

I Bing Maps görs administrativa gränser för länder, delstater, regioner, städer och postnummer tillgängliga via Geodata-API:et. Det här API:et använder antingen en koordinat eller en fråga att geokoda. Om en fråga skickas geokodas den och koordinaterna från det första resultatet används. Det här API:et tar koordinaterna och hämtar gränsen för den angivna entitetstyp som korsar koordinaten. Observera att det här API:et inte nödvändigtvis returnerade gränsen för den fråga som skickades. Om en fråga för skickas, men entitetstypens värde är inställt på landregion, returneras "Seattle, WA" gränsen för USA.

Azure Maps ger också åtkomst till administrativa gränser (länder, delstater, regioner, städer och postnummer). Om du vill hämta en gräns måste du fråga ett av sök-API:erna efter den gräns du vill ha (dvs. Seattle, WA ). Om sökresultatet har en associerad gräns anges ett geometri-ID i resultatsvaret. Sök-polygon-API:et kan sedan användas för att hämta de exakta gränserna för ett eller flera geometri-ID:n. Detta skiljer sig lite från Bing Maps eftersom Azure Maps returnerar gränsen för vad som genomsökts, medan Bing Maps returnerar en gräns för en angiven entitetstyp vid en angiven koordinat. Dessutom är gränsdata som returneras av Azure Maps i GeoJSON-format.

Sammanfattning:

  1. Skicka en fråga för gränsen som du vill ta emot till något av följande sök-API:er.
  2. Om de önskade resultaten har ett geometri-ID:n skickar du det till Search Polygon-API:et.

Köra frågor mot rumsliga affärsdata

Rumsliga datatjänster i Bing Maps är en enkel lösning för rumslig datalagring som kan vara värd för affärsdata och exponera dem som en rumslig REST-tjänst. Den här tjänsten innehåller fyra huvudfrågor: hitta efter egenskap, hitta i närheten, hitta i en begränsningsruta och hitta med 1 mil av en väg. Många företag som använder den här tjänsten har ofta redan sina affärsdata redan lagrade i en databas någonstans och har laddat upp en liten delmängd av dem till den här tjänsten för att driva program som butikslokaliserare. Eftersom nyckelbaserad autentisering ger grundläggande säkerhet rekommenderar vi att den här tjänsten endast används med offentliga data.

De flesta företagsplatsdata börjar i en databas. Därför rekommenderar vi att du använder befintliga Azure-lagringslösningar som Azure SQL eller Azure PostgreSQL (med PostGIS-plugin-programmet). Båda dessa lagringslösningar stöder rumsliga data och tillhandahåller en omfattande uppsättning funktioner för rumsliga frågor. När dina data finns i en lämplig lagringslösning kan de sedan integreras i ditt program genom att skapa en anpassad webbtjänst eller genom att använda ett ramverk som ASP.NET eller Entity Framework. Med den här metoden får du fler frågefunktioner och mycket högre säkerhetsalternativ.

Azure Cosmos DB också en begränsad uppsättning rumsliga funktioner som, beroende på ditt scenario, kan vara tillräckliga.

Här är några användbara resurser för att vara värd för och fråga rumsliga data i Azure.

Klientbibliotek

Azure Maps tillhandahåller klientbibliotek för följande programmeringsspråk:

Klientbibliotek med öppen källkod för andra programmeringsspråk;

Rensa resurser

Inga resurser ska rensas.

Nästa steg

Läs mer om Azure Maps REST-tjänster.