Rendera anpassade data på en rasterkarta

  • Artikel
  • 5 minuter för att läsa

I den här artikeln beskrivs hur du använder tjänsten för statiska bilder med funktioner för bildsammansättning. Funktionen för bildsammansättning stöder hämtning av statiska fönsterpaneler som innehåller anpassade data.

Följande är exempel på anpassade data:

  • Anpassade kartnålar
  • Etiketter
  • Överlägg för geometri

Tips

Om du vill visa en enkel karta på en webbsida är det ofta mer kostnadseffektivt att använda Azure Kartor Web SDK i stället för att använda tjänsten för statiska avbildningar. Webb-SDK:n använder kartpaneler. och om inte användaren panorerar och zoomar kartan genererar de ofta bara en bråkdel av en transaktion per kartbelastning. Azure Kartor web SDK har alternativ för att inaktivera panorering och zoomning. Dessutom tillhandahåller Azure Kartor web SDK en mer omfattande uppsättning alternativ för datavisualisering än en webbtjänst för statisk karta.

Förutsättningar

  1. Skapa ett Azure Kartor konto
  2. Skaffa en primär prenumerationsnyckel, som även kallas primärnyckel eller prenumerationsnyckel.

Den här artikeln använder Postman-programmet, men du kan använda en annan API-utvecklingsmiljö.

Vi använder Azure Kartor Data Service-API:er för att lagra och rendera överlägg.

Rendera kartnålar med etiketter och en anpassad avbildning

Anteckning

Proceduren i det här avsnittet kräver ett Azure Kartor-konto på prisnivån Gen 1 eller Gen 2. Azure Kartor Gen 1 Standard S0-nivån stöder bara en enda instans av pins parametern. Det gör att du kan rendera upp till fem kartnålar, som anges i URL-begäran, med en anpassad avbildning.

Hämta statisk bild med anpassade stift och etiketter

Så här hämtar du en statisk bild med anpassade stift och etiketter:

  1. I Postman-appen väljer du Nytt.

  2. I fönstret Skapa ny väljer du HTTP-begäran.

  3. Ange ett begärandenamn för begäran, till exempel GET Static Image.

  4. Välj METODEN GET HTTP.

  5. Ange följande URL (ersätt { Your-Azure-Maps-Primary-Subscription-key} med din primära prenumerationsnyckel):

    https://atlas.microsoft.com/map/static/png?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1.0&layer=basic&style=main&zoom=12&center=-73.98,%2040.77&pins=custom%7Cla15+50%7Cls12%7Clc003b61%7C%7C%27CentralPark%27-73.9657974+40.781971%7C%7Chttps%3A%2F%2Fraw.githubusercontent.com%2FAzure-Samples%2FAzureMapsCodeSamples%2Fmaster%2FAzureMapsCodeSamples%2FCommon%2Fimages%2Ficons%2Fylw-pushpin.png

  6. Välj Skicka.

  7. Tjänsten returnerar följande bild:

    En anpassad kartnål med en etikett.

Upload och sökvägsdata

Anteckning

Proceduren i det här avsnittet kräver en Azure Kartor Gen 1 (S1) eller Gen 2-prisnivå.

I det här avsnittet laddar vi upp sökvägen och fäster data i Azure Map-datalagringen.

Så här laddar du upp stift och sökvägsdata:

  1. I Postman-appen väljer du Nytt.

  2. I fönstret Skapa ny väljer du HTTP-begäran.

  3. Ange ett begärandenamn för begäran, till exempel POST-sökväg och Fäst data.

  4. Välj POST HTTP-metoden.

  5. Ange följande URL (ersätt { Your-Azure-Maps-Primary-Subscription-key} med din primära prenumerationsnyckel):

    https://us.atlas.microsoft.com/mapData?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=2.0&dataFormat=geojson

  6. Välj fliken brödtext.

  7. I listrutan väljer du raw och JSON.

  8. Kopiera följande JSON-data som data som ska laddas upp och klistra in dem i fönstret Brödtext:

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {},
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -73.98235,
              40.76799
            ],
            [
              -73.95785,
              40.80044
            ],
            [
              -73.94928,
              40.7968
            ],
            [
              -73.97317,
              40.76437
            ],
            [
              -73.98235,
              40.76799
            ]
          ]
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {},
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            -73.97624731063843,
            40.76560773817073
          ],
          [
            -73.97914409637451,
            40.766826609362575
          ],
          [
            -73.98513078689575,
            40.7585866048861
          ]
        ]
      }
    }
  ]
}

  9. Välj Skicka.

  10. I svarsfönstret väljer du fliken Rubriker.

  11. Kopiera värdet för nyckeln Operation-Location, som är status URL . Vi använder för att status URL kontrollera status för uppladdningsbegäran i nästa avsnitt. status URLhar följande format:

https://us.atlas.microsoft.com/mapData/operations/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx?api-version=2.0

Tips

Om du vill hämta din egen sökväg och fästa platsinformation använder du API:et Data Upload.

Kontrollera status för uppladdning av stift och sökvägsdata

Kontrollera statusen för datauppladdningen och hämta dess unika ID ( udid ):

  1. I Postman-appen väljer du Nytt.

  2. I fönstret Skapa ny väljer du HTTP-begäran.

  3. Ange ett begärandenamn för begäran, till exempel GET Data Upload Status.

  4. Välj METODEN GET HTTP.

  5. Ange den status URL som du kopierade Upload pins och sökvägsdata. Begäran bör se ut som följande URL (ersätt { Your-Azure-Maps-Primary-Subscription-key} med din primära prenumerationsnyckel):

      https://us.atlas.microsoft.com/mapData/operations/{statusUrl}?api-version=2.0&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

  6. Välj Skicka.

  7. I svarsfönstret väljer du fliken Rubriker.

  8. Kopiera värdet för nyckeln Resource-Location, som är resource location URL . resource location URLinnehåller den unika identifieraren ( ) för udid ritningspaketresursen.

    Kopiera resursplatsens URL.

Rendera uppladdade funktioner på kartan

Så här renderar du de uppladdade kartnålarna och sökvägsdata på kartan:

  1. I Postman-appen väljer du Nytt.

  2. I fönstret Skapa ny väljer du HTTP-begäran.

  3. Ange ett begärandenamn för begäran, till exempel GET Data Upload Status.

  4. Välj METODEN GET HTTP.

  5. Ange följande URL till Render Service (ersätt { med din Your-Azure-Maps-Primary-Subscription-key} primära prenumerationsnyckel udid och med för udid överladdade data):

    https://atlas.microsoft.com/map/static/png?subscription-key={Your-Azure-Maps-Primary-Subscription-key}&api-version=1.0&layer=basic&style=main&zoom=12&center=-73.96682739257812%2C40.78119135317995&pins=default|la-35+50|ls12|lc003C62|co9B2F15||'Times Square'-73.98516297340393 40.758781646381024|'Central Park'-73.96682739257812 40.78119135317995&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.30||udid-{udId}

  6. Tjänsten returnerar följande bild:

    Rendera överladdade data i en statisk kartbild.

Rendera en polygon med färg och opacitet

Anteckning

Proceduren i det här avsnittet kräver en Azure Kartor Gen 1 (S1) eller Gen 2-prisnivå.

Du kan ändra utseendet på en polygon med hjälp av formatmodifierare med sökvägsparametern.

Så här renderar du en polygon med färg och opacitet:

  1. I Postman-appen väljer du Nytt.

  2. I fönstret Skapa ny väljer du HTTP-begäran.

  3. Ange ett begärandenamn för begäran, till exempel GET Polygon.

  4. Välj METODEN GET HTTP.

  5. Ange följande URL till Render Service (ersätt { Your-Azure-Maps-Primary-Subscription-key} med din primära prenumerationsnyckel):

    https://atlas.microsoft.com/map/static/png?api-version=1.0&style=main&layer=basic&sku=S1&zoom=14&height=500&Width=500&center=-74.040701, 40.698666&path=lc0000FF|fc0000FF|lw3|la0.80|fa0.50||-74.03995513916016 40.70090237454063|-74.04082417488098 40.70028420372218|-74.04113531112671 40.70049568385827|-74.04298067092896 40.69899904076542|-74.04271245002747 40.69879568992435|-74.04367804527283 40.6980961582905|-74.04364585876465 40.698055487620714|-74.04368877410889 40.698022951066996|-74.04168248176573 40.696444909137|-74.03901100158691 40.69837271818651|-74.03824925422668 40.69837271818651|-74.03809905052185 40.69903971085914|-74.03771281242369 40.699340668780984|-74.03940796852112 40.70058515602143|-74.03948307037354 40.70052821920425|-74.03995513916016 40.70090237454063
&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

  6. Tjänsten returnerar följande bild:

    Rendera en täckande polygon.

Rendera en cirkel och kartnålar med anpassade etiketter

Anteckning

Proceduren i det här avsnittet kräver en Azure Kartor Gen 1 (S1) eller Gen 2-prisnivå.

Du kan ändra utseendet på stiften genom att lägga till formatmodifierare. Om du till exempel vill göra kartnålar och deras etiketter större eller mindre använder du sc modifieraren "skalningsstil". Den här modifieraren tar ett värde som är större än noll. Värdet 1 är standardskalan. Värden som är större än 1 gör stiften större och värden mindre än 1 gör dem mindre. Mer information om formatmodifierare finns i Parametrar för tjänstsökväg för statiska avbildningar.

Så här renderar du en cirkel och kartnålar med anpassade etiketter:

  1. I Postman-appen väljer du Nytt.

  2. I fönstret Skapa ny väljer du HTTP-begäran.

  3. Ange ett begärandenamn för begäran, till exempel GET Polygon.

  4. Välj METODEN GET HTTP.

  5. Ange följande URL till Render Service (ersätt { Your-Azure-Maps-Primary-Subscription-key} med din primära prenumerationsnyckel):

    https://atlas.microsoft.com/map/static/png?api-version=1.0&style=main&layer=basic&zoom=14&height=700&Width=700&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co002D62||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

  6. Välj Skicka.

  7. Tjänsten returnerar följande bild:

    Rendera en cirkel med anpassade kartnålar.

  8. Nu ska vi ändra färgen på kartnålarna genom att ändra co formatmodifieraren. Om du tittar på värdet för pins parametern ( pins=default|la15+50|al0.66|lc003C62|co002D62| ) ser du att den aktuella färgen är #002D62 . Om du vill ändra färgen #41d42a till ersätter vi #002D62 med #41d42a . Nu är pins parametern pins=default|la15+50|al0.66|lc003C62|co41D42A| . Begäran ser ut som följande URL:

    https://atlas.microsoft.com/map/static/png?api-version=1.0&style=main&layer=basic&zoom=14&height=700&Width=700&center=-122.13230609893799,47.64599069048016&path=lcFF0000|lw2|la0.60|ra1000||-122.13230609893799 47.64599069048016&pins=default|la15+50|al0.66|lc003C62|co41D42A||'Microsoft Corporate Headquarters'-122.14131832122801  47.64690503939462|'Microsoft Visitor Center'-122.136828 47.642224|'Microsoft Conference Center'-122.12552547454833 47.642940335653996|'Microsoft The Commons'-122.13687658309935  47.64452336193245&subscription-key={Your-Azure-Maps-Primary-Subscription-key}

  9. Välj Skicka.

  10. Tjänsten returnerar följande bild:

    Rendera en cirkel med uppdaterade kartnålar.

På samma sätt kan du ändra, lägga till och ta bort andra formatmodifierare.

Nästa steg