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

  • Artikel

Både Azure och Bing Kartor ge åtkomst till rumsliga API:er via REST-webbtjänster. API-gränssnitten för dessa plattformar har liknande funktioner men använder olika namngivningskonventioner och svarsobjekt. Den här självstudien visar hur du:

  • Vidarebefordra och omvänd geokodning
  • Söka efter platser av intresse
  • Beräkna vägar och vägbeskrivningar
  • Hämta en kartbild
  • Beräkna en avståndsmatris
  • Hämta information om tidszon

I följande tabell finns API:er för Azure Kartor-tjänsten som tillhandahåller liknande funktioner som de listade API:erna för Bing-Kartor-tjänsten.

API för Bing-Kartor-tjänsten Api för Azure Kartor-tjänsten
Automatiska förslag Sök
Riktningar (inklusive lastbil) Hämta vägbeskrivningar
Avståndsmatris Matris efter väg
Bilder – statisk karta Hämta statisk mappningsbild
Isochroner Hämta routningsintervall
Lokala insikter Sök + hämta routningsintervall
Lokal sökning Sök
Platsigenkänning (POIs) Sök
Platser (framåt-/omvänd geokodning) Sök
Fäst vid väg Vägbeskrivning efter väg
Spatial Data Services (SDS) Sökväg + + andra Azure-tjänster
Tidszon Tidszon
Trafikincidenter Hämta information om trafikincidenter

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

  • Optimerade resvägar – planerad. Azure Kartor Route API stöder optimering av resande säljare för ett enda fordon.
  • Bildmetadata – används främst för att hämta panel-URL:er i Bing Kartor. Azure Kartor har en fristående tjänst för direkt åtkomst till kartpaneler.

Azure Kartor har även dessa REST-webbtjänster:

  • Azure Kartor Creator – Skapa en anpassad privat digital tvilling med byggnader och utrymmen.
  • Spatiala åtgärder – Avlasta komplexa rumsliga beräkningar och åtgärder, till exempel geofencing, till en tjänst.
  • Hämta kartpanelen – Åtkomst till väg- och bildpaneler från Azure Kartor som raster- och vektorpaneler.
  • Post Route Directions Batch – 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.
  • Traffic Flow – Få åtkomst till trafikflödesdata i realtid som både raster- och vektorpaneler.
  • Geoplats-API – Hämta platsen för en IP-adress.
  • Vädertjänster – Få åtkomst till realtids- och prognostiserade väderdata.

Se även till att gå igenom följande metodtipsguider:

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Kommentar

Mer information om autentisering i Azure Kartor finns i Hantera autentisering i Azure Kartor.

Geokodningsadresser

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

Azure Kartor innehåller flera metoder för geokodningsadresser:

  • Hämta sökadress: Geokodning av friformuläradress används för att ange en enskild adresssträng (som "1 Microsoft way, Redmond, WA") och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt.
  • Hämta sökadress Strukturerad: Geokodning av strukturerad adress används för att ange delarna i en enda adress, till exempel gatunamn, ort, land/region och postnummer och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du snabbt behöver geokoda enskilda adresser och data redan parsas i dess enskilda adressdelar.
  • Batch för eftersökningsadress: Använd batchadressgeokodning för att skapa en begäran som innehåller upp till 10 000 adresser och få dem bearbetade under en tidsperiod. Alla adresser geokodas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned. Den här tjänsten rekommenderas för geokodning av stora datamängder.
  • Hämta sökfuzzy: FUZZY-sök-API:et kombinerar adressgeokodning med sökpunkt av intresse. Det här API:et tar in en sträng i fritt format som kan vara en adress, plats, landmärke, intressepunkt eller 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 intressanta platser från samma textruta.
  • Fuzzy Batch efter sökning: Använd den fuzzy batch-sökningen för att skapa en begäran som innehåller upp till 10 000 adresser, platser, landmärken eller intressen och få dem bearbetade under en tidsperiod. Alla data bearbetas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned.

Följande tabeller korsreferenserar API-parametrarna för Bing Kartor med jämförbara API-parametrar i Azure Kartor för geokodning av strukturerade och kostnadsfria adresser.

Plats efter adress (strukturerad adress)

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
addressLine streetNumber, streetName eller crossStreet
adminDistrict countrySubdivision
countryRegion country och countryCode
locality municipality eller municipalitySubdivision
postalCode postalCode
maxResults (maxRes) limit
includeNeighborhood (inclnb) N/A – Returneras alltid av Azure Kartor om det är tillgängligt.
include (incl) N/A – Lands-ISO2-kod returneras alltid av Azure Kartor.
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Azure Kartor stöder också:

  • countrySecondarySubdivision – Län, distrikt
  • countryTertiarySubdivision - Namngivna områden, stadsdelar, kantoner, kommuner
  • ofs – Bläddra igenom resultaten i kombination med maxResults parametern.

Plats efter fråga (friformsadresssträng)

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
query query
maxResults (maxRes) limit
includeNeighborhood (inclnb) N/A – Returneras alltid av Azure Kartor om det är tillgängligt.
include (incl) N/A – Lands-ISO2-kod returneras alltid av Azure Kartor.
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Azure Kartor stöder också:

  • typeahead – Anger om frågan tolkas som en partiell indata och sökningen går in i prediktivt läge (autosuggest/autocomplete).
  • countrySet – En kommaavgränsad lista över ISO2-landskoder där 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.

Mer information om hur du använder söktjänsten finns i Sök efter en plats med hjälp av Azure Kartor tjänsten Search s och metodtips för Azure Kartor tjänsten Search.

Omvänd geokoda en koordinat (Hitta en plats efter punkt)

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

Azure Kartor innehåller flera metoder för omvänd geokodning:

  • Hämta omvänd sökadress: Ange en enda geografisk koordinat för att hämta dess ungefärliga adress och bearbeta begäran omedelbart.
  • Hämta sökadress omvänd korsgata: Ange en enda geografisk koordinat för att få närliggande korsgatainformation (till exempel första och viktigaste) och bearbeta begäran omedelbart.
  • Omvänd batch efter sökadress: Skapa en begäran som innehåller upp till 10 000 koordinater och be dem bearbetas under en tidsperiod. Alla data bearbetas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned.

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
point query
includeEntityTypes entityType – Se jämförelsetabellen för entitetstyp nedan.
includeNeighborhood (inclnb) N/A – Returneras alltid av Azure Kartor om det är tillgängligt.
include (incl) N/A – Lands-ISO2-kod returneras alltid av Azure Kartor.
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Mer information om hur du söker i Azure Kartor finns i Metodtips för Azure Kartor tjänsten Search.

Api:et för omvänd geokodning i Azure Kartor har funktioner som inte är tillgängliga i Bing Kartor 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, artär, begränsad åtkomst, ramp osv.
  • Sidan av gatan koordinaten faller på.

Jämförelsetabell för entitetstyp

Följande tabellkors refererar till värdena för Bing Kartor entitetstyp till motsvarande egenskapsnamn i Azure Kartor.

Entitetstyp för Bing Kartor Jämförbar Azure Kartor-entitetstyp beskrivning
Address Address
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 Län eller distrikt
CountryRegion Country Namn på land
CountryTertiarySubdivision Boroughs, Cantons, Communes

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

Flera av Azure Kartor-sök-API:ets stöd för förutsägelseläge som kan användas för scenarier med automatiska förslag. Api:et för fuzzy-sökning i Azure Kartor är mest likt API:et för automatiska förslag i Bing Kartor. Följande API:er har också stöd för prediktivt läge och lägger till &typeahead=true i frågan:

  • Hämta sökadress: En geokodning av friformsadress som används för att ange en enskild adresssträng (som "1 Microsoft way, Redmond, WA") och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt.
  • Hämta sökfuzzy: FUZZY-sök-API:et kombinerar adressgeokodning med sökpunkt av intresse. Det här API:et tar in en sträng i fritt format som kan vara en adress, plats, landmärke, intressepunkt eller 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 intressanta platser från samma textruta.
  • Hämta sökpunkt: Sökningen efter intressepunkter (POI) används för att söka efter intressepunkter efter namn. Exempel: "starbucks"
  • Get Search POI Category( Get Search POI Category: Point of Interest(POI)-kategorisökning används för att söka efter intressepunkter efter kategori. Till exempel "restaurang".

Beräkna vägar och vägbeskrivningar

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

  • ankomst- och avgångstider
  • realtids- och förutsägelsebaserade trafikvägar
  • olika transportsätt, körning, gång, lastbil
  • waypoint orderoptimering (resande säljare)

Kommentar

Azure Kartor kräver att alla waypoints är koordinater. Adresser måste geokodas först.

Azure Kartor-routningstjänsten tillhandahåller följande API:er för att beräkna vägar:

  • Hämta vägbeskrivningar: Beräkna en väg och be begäran bearbetas 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 av routningsalternativen för att säkerställa att URL-begäran inte blir för lång och orsakar problem.
  • Post Route Directions Batch: Skapa en begäran som innehåller upp till 1 000 routningsbegäranden och få dem bearbetade under en tidsperiod. Alla data bearbetas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned.

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
avoid avoid
dateTime (dt) departAt eller arriveAt
distanceBeforeFirstTurn (dbft) Ej tillämpligt
distanceUnit (du) N/A – Azure Kartor använder bara måttsystemet.
heading (hd) vehicleHeading
maxSolutions (maxSolns) maxAlternatives, alternativeType, minDeviationDistanceoch 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– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Azure Kartor routnings-API:et stöder även lastbilsroutning inom samma API. Följande tabell korsreferenser till de andra Bing-Kartor lastbilsroutningsparametrar med jämförbara API-parametrar i Azure Kartor.

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

Dricks

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

Mer information om Azure Kartor routnings-API finns i Metodtips för Azure Kartor Route-tjänsten.

Azure Kartor routnings-API:et har funktioner som inte är tillgängliga i Bing Kartor som kan vara användbara att integrera när du migrerar din app:

  • Stöd för rutttyp: kortast, snabbaste, trilling och mest bränsleeffektiva.
  • Stöd för fler reselägen: cykel, buss, motorcykel, taxi, lastbil och van.
  • Stöd för 150 vägpunkter.
  • Beräkna flera restider i en enda begäran, historisk trafik, livetrafik, ingen trafik.
  • Undvik ytterligare vägtyper: samåkningsvägar, osparade vägar, redan använda vägar.
  • Motorspecifikationsbaserad routning. Beräkna vägar för förbrännings- eller elfordon baserat på deras återstående bränsle-/laddnings- och motorspecifikationer.
  • Ange högsta fordonshastighet.

Fäst koordinater på väg

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

  • Använd vägriktnings-API:et för att fästa koordinater till en logisk väg längs vägnätet.
  • Använd Azure Kartor Web SDK för att fästa enskilda koordinater till närmaste väg i vektorpanelerna.
  • Använd vektorpanelerna i Azure Kartor direkt för att fästa enskilda koordinater.

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

Azure Kartor kan fästa koordinater till vägar med hjälp av API:et Hämta vägriktningar. Den här tjänsten kan användas för att rekonstruera en logisk väg mellan en uppsättning koordinater och kan jämföras med Bing-Kartor Snap to Road API.

Det finns två olika sätt att använda vägriktnings-API:et för att fästa koordinater till vägar.

  • Om det finns 150 koordinater eller mindre kan de skickas som vägpunkter i routningsriktnings-API:et GET . Med den här metoden kan två olika typer av snappade data hämtas. väginstruktioner innehåller de enskilda snappade vägpunkterna, medan vägsökvä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 routningsriktnings-API:et POST användas. Koordinaternas start- och slutkoordinater måste skickas till frågeparametern, men alla koordinater kan skickas till parametern supportingPoints i brödtexten POST i begäran och formateras med en GeoJSON-geometrisamling med punkter. De enda data som är tillgängliga med den här metoden är den vägsökväg som är en interpolerad uppsättning koordinater som fyller den fullständiga sökvägen mellan koordinaterna. Om du vill se ett exempel på den här metoden med hjälp av tjänstmodulen i Azure Kartor Web SDK kan du läsa exemplet snappunkter till logisk vägsökväg i Azure Kartor-exemplen.

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
points supportingPoints – skicka dessa punkter till brödtexten i POST begäran
interpolate Saknas
includeSpeedLimit Saknas
includeTruckSpeedLimit Saknas
speedUnit Saknas
travelMode travelMode
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Azure Kartor-routnings-API:et stöder även lastbilsroutningsparameter i samma API för att säkerställa att logiska sökvägar beräknas. Följande tabell korsreferenser till de andra Bing-Kartor lastbilsroutningsparametrar med jämförbara API-parametrar i Azure Kartor.

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

Eftersom den här metoden använder routningsriktnings-API:et kan den fullständiga uppsättningen alternativ i den 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 historiska trafikdata beaktas.

Api:et för Vägbeskrivningar i Azure Kartor returnerar för närvarande inte hastighetsbegränsningsdata, men det kan hämtas med hjälp av Azure Kartor API för omvänd geokodning.

Använda Web SDK för att fästa koordinater

Azure Kartor Web SDK använder vektorpaneler för att återge kartorna. Dessa vektorpaneler innehåller information om rå väggeometri och kan användas för att beräkna närmaste väg till en koordinat för enkel snappning 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 Kartor Web SDK för att visualisera data.

Den här metoden fäster dock bara på de vägsegment som läses in i kartvyn. När du zoomar ut på land-/regionnivå kanske det inte finns några vägdata, så snapping kan inte göras, men på den zoomnivån kan en enda bildpunkt representera området för flera stadsblock så att snappning inte behövs. För att åtgärda detta kan fästlogik tillämpas varje gång kartan har flyttats. Om du vill se ett fullt funktionellt exempel på den här snappinglogik kan du läsa exempel på enkel snap-to-road-logik i Azure Kartor-exemplen.

Använda Azure Kartor-vektorpaneler direkt för att fästa koordinater

Azure Kartor-vektorpaneler innehåller rådata för väggeometri som kan användas för att beräkna närmaste punkt på en väg till en koordinat för att utföra grundläggande snappning av enskilda koordinater. Alla vägsegment visas i sektorer på zoomnivå 15, så du vill hämta paneler därifrån. Du kan sedan använda pyramidmatematiken för quadtree-paneler för att fastställa att paneler behövs och konvertera panelerna till geometrier. Därifrån kan ett rumsligt matematikbibliotek, till exempel turf js eller NetTopologySuite , användas för att beräkna närmaste linjesegment.

Hämta en kartbild (statisk karta)

Azure Kartor tillhandahåller ett API för att återge statiska kartbilder med överlagrade data. Azure Kartor Get Map Static Image API är jämförbart med API:et för statisk karta i Bing Kartor.

Kommentar

Azure Kartor kräver att centret, alla pushpins och sökvägsplatser är koordinater i longitude,latitude format medan Bing Kartor använder latitude,longitude formatet. Adresser måste geokodas först.

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
centerPoint center
format format – anges som en del av URL-sökvägen. För närvarande stöds endast PNG.
heading N/A – Streetside stöds inte.
imagerySet layer och style – Mer information finns i Kartformat som stöds.
mapArea (ma) bbox
mapLayer (ml) Ej tillämpligt
mapSize (ms) width och height – kan vara upp till 8192x8192 i storlek.
declutterPins (dcl) Saknas
dpi Saknas
drawCurve path
mapMetadata Saknas
pitch N/A – Streetside stöds inte.
pushpin (pp) pins
zoomLevel zoom
query N/A – mitt- eller avgränsningsruta måste användas.
highlightEntity (he) Saknas
style Saknas
vägparametrar Ej tillämpligt
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Kommentar

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

Mer information finns i Rendera anpassade data på en rasterkarta.

Förutom att kunna generera en statisk kartbild ger Tjänsten Azure Kartor återgivning även direkt åtkomst till kartpaneler i rastreringsformat (PNG) och vektorformat:

Jämförelse av pushpin-URL-parameterformat

Före: Bing Kartor

I Bing Kartor kan du lägga till pushpins i en statisk kartbild med hjälp av parametern pushpin i URL:en. Parametern pushpin tar in en plats i latitude,longitude format, ett ikonformat och en textetikett (upp till tre tecken) enligt nedan:

&pushpin=latitude,longitude;iconStyle;label

Du kan lägga till pushpins genom att lägga till fler pushpin parametrar i URL:en med en annan uppsättning värden. Pushpin-ikonformat är begränsade till ett av de fördefinierade formaten som är tillgängliga i API:et för Bing Kartor.

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

&pushpin=45,-110;7;AB

Bing Maps static map pin

Efter: Azure Kartor

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

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

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

När det gäller pin-platser kräver Azure Kartor att koordinaterna är i longitude,latitude format medan Bing Kartor använder latitude,longitude format. Observera också att det finns ett utrymme, inte ett kommatecken som skiljer longitud och latitud i Azure Kartor.

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 parametern pins efter fästplatsinformationen.

Pin-format i Azure Kartor läggs till med formatet optionNameValue, med flera format som avgränsas med pipe-tecken (|) som det här iconType|optionName1Value1|optionName2Value2. Observera att alternativnamnen och värdena inte är avgränsade. Följande formatalternativnamn kan användas för att formatera pushpins i Azure Kartor:

  • al – Anger opacity (alfa) för pushpins. Kan vara ett tal mellan 0 och 1.
  • an – Anger fästpunkten. X- och y-pixelvärden som anges i formatet x y.
  • co – Färgen på stiftet. Måste vara en 24-bitars hexfärg: 000000 till FFFFFF.
  • la – Anger etikettens fästpunkt. X- och y-pixelvärden som anges i formatet x y.
  • lc – Etikettens färg. Måste vara en 24-men hex färg: 000000 till FFFFFF.
  • ls – Storleken på etiketten i bildpunkter. Kan vara ett tal 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 större än 0.

Etikettvärden anges för varje fästplats i stället för att ha ett enda etikettvärde som gäller för alla pushpins i listan över platser. Etikettvärdet kan vara en sträng med flera tecken och omslutas med enkla citattecken för att säkerställa att det inte misstas som ett format- eller platsvärde.

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

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

Azure Maps static map pin

I följande exempel läggs tre pins 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 static map multiple pins

Jämförelse av url-parameterformat för ritad kurva

Före: Bing Kartor

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

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

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

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

Formtyper i Bing Kartor inkluderar linjer, polygoner, cirkel och kurva. Formattyper inkluderar linjefärg, linjetjocklek, konturfärg, fyllningsfärg, konturtjocklek och cirkelradie.

I Bing Kartor kan till exempel en blå linje med 50 % opacitet och en tjocklek på fyra bildpunkter läggas till på 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

Bing Maps static map line

Efter: Azure Kartor

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

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

När det gäller sökvägsplatser kräver Azure Kartor att koordinaterna är i longitude,latitude format medan Bing Kartor använder latitude,longitude format. Observera också att det finns ett utrymme, inte ett kommatecken som skiljer longitud och latitud i Azure Kartor. Azure Kartor stöder för närvarande inte kodade sökvägar.

Sökvägsformat i Azure Kartor läggs till med formatet optionNameValue, med flera format som avgränsas med pipe-tecken (|) som det här 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 Kartor:

  • fa – Fyllningsfärgens opacitet (alfa) som används vid återgivning av polygoner. Kan vara ett tal mellan 0 och 1.
  • fc – Den fyllningsfärg som används för att återge området för en polygon.
  • la – Linjefärgens opacitet (alfa) som används vid återgivning 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 cirklarradie i meter.

I Azure Kartor kan till exempel en blå linje med 50 % opacitet och en tjocklek på fyra bildpunkter läggas till på 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 static map line

Beräkna en avståndsmatris

Azure Kartor tillhandahåller ett API för att beräkna restider och avstånd mellan en uppsättning platser som en avståndsmatris. Api:et för Azure Kartor-avståndsmatrisen är jämförbart med avståndsmatris-API:et i Bing Kartor:

  • Matris efter väg: Beräknar asynkront 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.

Kommentar

En begäran till avståndsmatris-API:et kan endast göras med hjälp av en POST begäran med ursprungs- och målinformationen i brödtexten i begäran. Dessutom kräver Azure Kartor att alla ursprung och mål är koordinater. Adresser måste geokodas först.

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
origins origins – ange i begärandetexten POST som GeoJSON.
destinations destination – ange i begärandetexten POST som GeoJSON.
endTime arriveAt
startTime departAt
travelMode travelMode
resolution Ej tillämpligt
distanceUnit N/A – Alla avstånd i meter.
timeUnit N/A – Alla tider i sekunder.
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Dricks

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

Beräkna en isochron

Azure Kartor tillhandahåller ett API för att beräkna en isochron, en polygon som täcker ett område som kan färdas i valfri riktning från en ursprungspunkt inom en angiven tid eller mängd bränsle/avgift. Api:et för Azure Kartor-routningsintervall är jämförbart med isochron-API:et i Bing Kartor.

  • Routningsintervall : Beräkna en polygon som täcker ett område som kan färdas i valfri riktning från en ursprungspunkt inom en angiven tid, ett visst avstånd eller en mängd bränsle/laddning som är tillgänglig.

Kommentar

Azure Kartor kräver att frågeursprunget är en koordinat. Adresser måste geokodas först.

Bing-Kartor kan också beräkna isochroner baserat på tid eller avstånd, medan Azure Kartor kan beräkna isochron baserat på tid, avstånd eller mängden bränsle/laddning som är tillgänglig.

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
waypoint (wp) query
dateTime (dt) departAt
maxTime timeBudgetInSec
timeUnit (tu) N/A – Alla tider i sekunder.
travelMode (mode) travelMode
maxDistance (maxDis) distanceBudgetInMeters
distanceUnit (du) N/A – Alla avstånd i meter.
optimize (optmz) routeType
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Dricks

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

Söka efter platser av intresse

Intressanta data kan sökas i Bing Kartor med hjälp av följande API:er:

  • Lokal sökning: Söker efter intressanta platser i närheten (radiell sökning), efter namn eller efter entitetstyp (kategori). Api:erna för Azure Kartor Get Search POI och Get Search POI Category är mest som det här API:et.
  • Platsigenkänning: Söker efter intressepunkter som ligger inom ett visst avstånd från en plats. Sök-API:et för Azure Kartor i närheten liknar det här API:et.
  • Lokala insikter: Söker efter intressepunkter som ligger inom en angiven maximal körtid eller avstånd från en specifik koordinat. Detta kan uppnås med Azure Kartor genom att först beräkna en isochron och sedan skicka den till API:et Sök inom geometri.

Azure Kartor tillhandahåller flera sök-API:er för intressanta platser:

  • Hämta sökpunkt: Sökningen efter intressepunkter (POI) används för att söka efter intressepunkter efter namn. Exempel: "starbucks"
  • Get Search POI Category( Get Search POI Category: Point of Interest(POI)-kategorisökning används för att söka efter intressepunkter efter kategori. Till exempel "restaurang".
  • Eftersökning inuti geometri: Söker efter intressepunkter som ligger inom ett visst avstånd från en plats eller inom en angiven geometri (polygon).
  • Hämta sökfuzzy: FUZZY-sök-API:et kombinerar adressgeokodning med sökpunkt av intresse. Det här API:et tar in en sträng i fritt format som kan vara en adress, plats, landmärke, intressepunkt eller 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 intressanta platser från samma textruta.
  • Eftersökning längs vägen: Sök efter intressepunkter som finns längs en angiven vägväg.
  • Fuzzy Batch efter sökning: Använd den fuzzy batch-sökningen för att skapa en begäran som innehåller upp till 10 000 adresser, platser, landmärken eller intressen och få dem bearbetade under en tidsperiod. Alla data bearbetas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned.

Mer information om hur du söker i Azure Kartor finns i Metodtips för Azure Kartor tjänsten Search.

Hämta trafikincidenter

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

  • Flödesdata – ger mått på trafikflödet på vägavsnitt. Detta används ofta för att färga kodvägar. Dessa data uppdateras var 2:e minut.
  • Incidentdata – innehåller data om konstruktion, vägavstängningar, olyckor och andra incidenter som kan påverka trafiken. Dessa data uppdateras varje minut.

Bing-Kartor 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 Azure Kartor interaktiva kartkontroller. Azure Maps innehåller också följande API:er för trafiktjänster:

  • Hämta trafikflödessegment: Innehåller information om hastigheterna och restiderna för vägfragmentet närmast de angivna koordinaterna.
  • Panelen Hämta trafikflöde: Innehåller raster- och vektorpaneler som innehåller trafikflödesdata. Dessa kan användas med Azure Kartor-kontroller eller i mappningskontroller från tredje part, till exempel Broschyr. Vektorpanelerna kan också användas för avancerad dataanalys.
  • Hämta information om trafikincidenter: Innehåller information om trafikincidenter som finns i en avgränsningsruta, zoomnivå och trafikmodell.
  • Panelen Hämta trafikincident: Innehåller raster- och vektorpaneler som innehåller trafikincidentdata.
  • Hämta vyport för trafikincident: Hämtar den juridiska och tekniska informationen för det visningsområde som beskrivs i begäran, till exempel trafikmodell-ID:t.

I följande tabell korsreferenser refererar Bing Kartor trafik-API-parametrar med api-parametrarna för jämförbar trafikincidentinformation i Azure Kartor.

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
mapArea boundingBox och boundingZoom
includeLocationCodes Ej tillämpligt
severity (s) N/A – alla data som returneras
type (t) N/A – alla data som returneras
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Hämta en tidszon

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

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

API-parametern för Bing Kartor Jämförbar Azure Kartor API-parameter
point query
query N/A – platser måste geokodas först.
dateTime timeStamp
includeDstRules N/A – Ingår alltid i svar från Azure Kartor.
key subscription-key– Mer information finns i Autentisering med Azure Kartor.
culture (c) language– Mer information finns i Stöd för lokalisering i Azure Kartor.
userRegion (ur) view– Mer information finns i Azure Kartor vyer som stöds.

Utöver detta tillhandahåller Azure Kartor-plattformen även många andra tidszons-API:er för att hjälpa till med konverteringar med tidszonsnamn och ID:t:

  • Hämta tidszon efter ID: Returnerar aktuell, historisk och framtida tidszonsinformation för angivet IANA-tidszons-ID.
  • Hämta Timezone Enum IANA: Returnerar en fullständig lista över IANA-tidszons-ID:er. Uppdateringar till IANA-tjänsten återspeglas i systemet inom en dag.
  • Hämta Timezone Enum Windows: Returnerar en fullständig lista över Windows tidszons-ID:er.
  • Hämta IANA-version för tidszon: Returnerar det aktuella IANA-versionsnumret som används av Azure Kartor.
  • Hämta Tidszonsfönster till IANA: Returnerar ett motsvarande IANA-ID, givet ett giltigt Windows-tidszons-ID. Flera IANA-ID:er kan returneras för ett enda Windows-ID.

Spatial Data Services (SDS)

De rumsliga datatjänsterna i Bing Kartor tillhandahålla tre viktiga funktioner:

  • Batch-geokodning – Bearbeta en stor batch med adressgeokoder med en enda begäran.
  • Hämta administrativa gränsdata – Använd en koordinat och hämta en korsande gräns för en angiven entitetstyp.
  • Värd- och frågedata för rumslig verksamhet – Ladda upp en enkel 2D-tabell med data och få åtkomst till dem med hjälp av några enkla rumsliga frågor.

Batch geocode-data

Batch-geokodning är processen att ta ett stort antal adresser eller platser, skicka dem alla i en enda begäran till en tjänst och låta alla geokodas parallellt och resultaten returneras i ett enda svar.

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

Azure Kartor har en batch-geokodningstjänst, men tillåter att upp till 10 000 adresser skickas i en enda begäran och bearbetas under 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.

Ett annat alternativ för geokodning av ett stort antal adresser med Azure Kartor är att göra parallella begäranden till standardsök-API:erna. Dessa tjänster accepterar endast 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 Kartor-plattformen från ett enda konto. Så om du bearbetar dessa för att hålla dig inom den gränsen är det möjligt att geokoda upp till 180 000 adresser i timmen. Prisnivån Gen2 eller Gen1 (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 hjälp av batch-geokodningstjänsten minskar den totala mängden data som överförs, vilket minskar nätverkstrafiken.

Kommentar

Azure Kartor Gen1-prisnivån dras tillbaka

Prisnivån Gen1 är nu inaktuell och dras tillbaka den 26-09-15. Prisnivån Gen2 ersätter Gen1 (både S0 och S1). Om ditt Azure Kartor-konto har valt prisnivån Gen1 kan du växla till prisnivån Gen2 innan den dras tillbaka, annars uppdateras den automatiskt. Mer information om tillbakadragning av Gen1-prisnivå finns i Hantera prisnivån för ditt Azure Kartor-konto.

  • Hämta sökadress: Geokodning av friformuläradress används för att ange en enskild adresssträng (som "1 Microsoft way, Redmond, WA") och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du behöver geokoda enskilda adresser snabbt.
  • Hämta sökadress Strukturerad: Geokodning av strukturerad adress används för att ange delarna i en enda adress, till exempel gatunamn, ort, land/region och postnummer och bearbeta begäran omedelbart. Den här tjänsten rekommenderas om du snabbt behöver geokoda enskilda adresser och data redan parsas i dess enskilda adressdelar.
  • Batch för eftersökningsadress: Använd batchadressgeokodning för att skapa en begäran som innehåller upp till 10 000 adresser och få dem bearbetade under en tidsperiod. Alla adresser geokodas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned. Den här tjänsten rekommenderas för geokodning av stora datamängder.
  • Hämta sökfuzzy: FUZZY-sök-API:et kombinerar adressgeokodning med sökpunkt av intresse. Det här API:et tar in en sträng i fritt format som kan vara en adress, plats, landmärke, intressepunkt eller 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 intressanta platser från samma textruta.
  • Fuzzy Batch efter sökning: Använd den fuzzy batch-sökningen för att skapa en begäran som innehåller upp till 10 000 adresser, platser, landmärken eller intressen och få dem bearbetade under en tidsperiod. Alla data bearbetas parallellt på servern och när de är klara kan den fullständiga resultatuppsättningen laddas ned.

Hämta administrativa gränsdata

I Bing Kartor görs administrativa gränser för länder/regioner, delstater, län, städer och postnummer tillgängliga via Geodata-API:et. Det här API:et tar in antingen en koordinat eller fråga till geokod. Om en fråga skickas är den geokodad 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. Det här API:et returnerade inte nödvändigtvis gränsen för frågan som skickades in. Om en fråga för skickas in, men värdet för "Seattle, WA" entitetstypen är inställt på land/region, returneras gränsen för USA.

Azure Kartor ger också åtkomst till administrativa gränser (länder/regioner, stater, län, städer och postnummer). Om du vill hämta en gräns måste du fråga något av sök-API:erna efter den gräns du vill använda (till exempel Seattle, WA). Om sökresultatet har en associerad gräns anges ett geometri-ID i resultatsvaret. Sökpolygon-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-Kartor eftersom Azure Kartor returnerar gränsen för det som genomsöktes, medan Bing Kartor returnerar en gräns för en angiven entitetstyp vid en angiven koordinat. Dessutom är gränsdata som returneras av Azure Kartor i GeoJSON-format.

Sammanfattning:

  1. Skicka en fråga för den gräns som du vill ta emot i något av följande sök-API:er.

  2. Om önskat resultat har ett geometri-ID skickar du det till API:et Hämta sökpolygon .

Värd- och frågedata för rumslig verksamhet

De rumsliga datatjänsterna i Bing Kartor tillhandahålla enkel rumslig datalagringslösning för att hantera 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 avgränsningsrutan och hitta med 1 mil av en rutt. Många företag som använder den här tjänsten har ofta redan sina affärsdata lagrade i en databas någonstans och har laddat upp en liten delmängd av den 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 affärsplatsdata börjar i en databas. Därför rekommenderar vi att du använder befintliga Azure Storage-lösningar som Azure SQL eller Azure PostgreSQL (med PostGIS-plugin-programmet). Båda dessa lagringslösningar stöder rumsliga data och ger en omfattande uppsättning rumsliga frågefunktioner. 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. Den här metoden är säkrare och ger fler frågefunktioner.

Azure Cosmos DB innehåller 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 hantera och köra frågor mot rumsliga data i Azure.

Klientbibliotek

Azure Kartor 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 Kartor REST-tjänster.

Metodtips för Azure Kartor tjänsten Search