Aangepaste gegevens weergeven op een rasterkaart

  • Artikel

In dit artikel wordt beschreven hoe u de opdracht Get Map Static Image gebruikt met de functionaliteit voor het samenstellen van afbeeldingen. De functionaliteit voor het samenstellen van afbeeldingen ondersteunt het ophalen van statische rastertegels die aangepaste gegevens bevatten.

Hier volgen voorbeelden van aangepaste gegevens:

  • Aangepaste punaises
  • Etiketten
  • Geometrie-overlays

Tip

Als u een eenvoudige kaart op een webpagina wilt weergeven, is het vaak rendabeler om de Azure Kaarten Web SDK te gebruiken in plaats van de statische installatiekopieënservice te gebruiken. De web-SDK maakt gebruik van kaarttegels; en tenzij de gebruiker de kaart pannen en zoomt, genereren ze vaak slechts een fractie van een transactie per kaartbelasting. De Azure Kaarten Web SDK bevat opties voor het uitschakelen van pannen en zoomen. De Azure Kaarten Web SDK biedt ook een uitgebreidere set opties voor gegevensvisualisatie dan een statische kaartwebservice wel.

Vereisten

In dit artikel wordt de Postman-toepassing gebruikt, maar u kunt een andere API-ontwikkelomgeving gebruiken.

Belangrijk

Vervang in de URL-voorbeelden door {Your-Azure-Maps-Subscription-key} uw Azure Kaarten-abonnementssleutel.

Punaises weergeven met labels en een aangepaste afbeelding

Notitie

Voor de procedure in deze sectie is een Azure Kaarten-account in de prijscategorie Gen1 of Gen2 vereist. De prijscategorie Azure Kaarten account Gen1 S0 ondersteunt slechts één exemplaar van de parameter pinnen. Hiermee kunt u maximaal vijf punaises weergeven, die zijn opgegeven in de URL-aanvraag, met een aangepaste afbeelding.

Buitengebruikstelling van Azure Kaarten Gen1-prijscategorie

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

Statische afbeelding ophalen met aangepaste spelden en labels

Een statische afbeelding met aangepaste spelden en labels ophalen:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer een aanvraagnaam in voor de aanvraag, zoals Get Map Static Image.

  4. Selecteer de GET HTTP-methode.

  5. Voer de volgende URL in:

    https://atlas.microsoft.com/map/static/png?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2022-08-01&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%2Fsamples.azuremaps.com%2Fimages%2Ficons%2Fylw-pushpin.png

  6. Selecteer Verzenden.

  7. De service retourneert de volgende afbeelding:

    A custom pushpin with a label.

Een veelhoek met kleur en dekking weergeven

Notitie

Voor de procedure in deze sectie is een prijscategorie Azure Kaarten account Gen1 (S1) of Gen2 vereist.

U kunt het uiterlijk van een veelhoek wijzigen met behulp van stijlaanpassingen met de padparameter .

Een veelhoek met kleur en dekking weergeven:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer een aanvraagnaam in voor de aanvraag, zoals GET Polygon.

  4. Selecteer de GET HTTP-methode.

  5. Voer de volgende URL in voor de Render-service :

    https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&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-Subscription-key}

  6. De service retourneert de volgende afbeelding:

    Render an opaque polygon.

Een cirkel en punaises weergeven met aangepaste labels

Notitie

Voor de procedure in deze sectie is een prijscategorie Azure Kaarten account Gen1 (S1) of Gen2 vereist.

U kunt het uiterlijk van de spelden wijzigen door stijlaanpassingen toe te voegen. Als u bijvoorbeeld punaises en hun labels groter of kleiner wilt maken, gebruikt u de sc modifier 'schaalstijl'. Deze wijzigingsfunctie gebruikt een waarde die groter is dan nul. Een waarde van 1 is de standaardschaal. Waarden groter dan 1 maken de pinnen groter en waarden kleiner dan 1 maken ze kleiner. Zie de padparameter van de opdracht Statische afbeelding ophalen voor meer informatie over stijlaanpassingen.

Een cirkel en punaises weergeven met aangepaste labels:

  1. Selecteer Nieuw in de Postman-app.

  2. Selecteer HTTP-aanvraag in het venster Nieuw maken.

  3. Voer een aanvraagnaam in voor de aanvraag, zoals GET Polygon.

  4. Selecteer de GET HTTP-methode.

  5. Voer de volgende URL in voor de Render-service :

    https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&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-Subscription-key}

  6. Selecteer Verzenden.

  7. De service retourneert de volgende afbeelding:

    Render a circle with custom pushpins.

  8. Wijzig vervolgens de kleur van de punaises door de co stijlaanpassing te wijzigen. Als u de waarde van de pins parameter (pins=default|la15+50|al0.66|lc003C62|co002D62|) bekijkt, ziet u dat de huidige kleur is #002D62. Als u de kleur wilt #41d42awijzigen in , vervangt u door #002D62#41d42a. pins De parameter is pins=default|la15+50|al0.66|lc003C62|co41D42A|nu . De aanvraag ziet eruit als de volgende URL:

    https://atlas.microsoft.com/map/static/png?api-version=2022-08-01&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-Subscription-key}

  9. Selecteer Verzenden.

  10. De service retourneert de volgende afbeelding:

    Render a circle with updated pushpins.

Op dezelfde manier kunt u andere stijlaanpassingen wijzigen, toevoegen en verwijderen.

Volgende stappen

Render - Statische kaartafbeelding ophalen