Vykreslení vlastních dat na rastrové mapě

  • Článek
  • 4 min ke čtení

Tento článek popisuje, jak používat statickou službu obrázků s funkcemi pro složení obrázků. Funkce pro složení obrázků podporuje načtení statické rastrové dlaždice, která obsahuje vlastní data.

Tady jsou příklady vlastních dat:

  • Vlastní připínáčky
  • Popisky
  • Překryvy geometrie

Tip

Pokud chcete na webové stránce zobrazit jednoduchou mapu, je často cenově výhodnější použít sadu Azure Mapy Web SDK místo použití statické služby obrázků. Webová sada SDK používá dlaždice map. a pokud uživatel neposouváním a přibližuje mapu, často vygeneruje pouze zlomek transakce na načtení mapy. Sada Azure Mapy Web SDK nabízí možnosti pro zakázání posouvání a přiblížení. Sada Azure Mapy Sdk navíc poskytuje bohatší sadu možností vizualizace dat než webová služba statické mapy.

Požadavky

  1. Nastavení účtu azure Mapy
  2. Získejte primární klíč předplatného, označované také jako primární klíč nebo klíč předplatného.

Tento článek používá aplikaci Postman, ale můžete použít jiné vývojové prostředí API.

K ukládání a vykreslování překryvných Mapy použijeme rozhraní API služby Azure Mapy Data Service.

Vykreslení připínáků s popisky a vlastním obrázkem

Poznámka

Postup v této části vyžaduje účet Azure Mapy cenovou úroveň 1. nebo 2. generace. Úroveň Standard Mapy Azure 1 Podporuje pouze jednu instanci pins parametru. Umožňuje vykreslit až pět připínáků zadaných v požadavku URL s vlastním obrázkem.

Získání statického obrázku s vlastními špendlíky a popisky

Získání statického obrázku s vlastními špendlíky a popisky:

  1. V aplikaci Postman vyberte Nový.

  2. V okně Vytvořit nový vyberte Požadavek HTTP.

  3. Zadejte název požadavku, například GET Static Image.

  4. Vyberte metodu GET HTTP.

  5. Zadejte následující adresu URL (nahraďte { Your-Azure-Maps-Primary-Subscription-key} primárním klíčem předplatného):

    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. Vyberte Odeslat.

  7. Služba vrátí následující obrázek:

    Vlastní připínák s popiskem

Upload špendlíků a dat cesty

Poznámka

Postup v této části vyžaduje cenovou úroveň azure Mapy Gen 1 (S1) nebo Gen2.

V této části nahrajeme cestu a připnutí dat do úložiště dat map Azure.

Nahrání špendlíků a dat cest:

  1. V aplikaci Postman vyberte Nový.

  2. V okně Vytvořit nový vyberte Požadavek HTTP.

  3. Zadejte název požadavku, například Cesta POST a Připnout data.

  4. Vyberte metodu POST HTTP.

  5. Zadejte následující adresu URL (nahraďte { Your-Azure-Maps-Primary-Subscription-key} primárním klíčem předplatného):

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

  6. Vyberte kartu Text.

  7. V rozevíracích seznamech vyberte raw a JSON.

  8. Zkopírujte následující data JSON jako data, která se nahrají, a vložte je do okna Text:

    {
  "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. Vyberte Odeslat.

  10. V okně odpovědi vyberte kartu Hlavičky.

  11. Zkopírujte hodnotu klíče Operation-Location, což je status URL . Ke kontrole stavu žádosti o nahrání použijeme status URL v další části . Má status URL následující formát:

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

Tip

Pokud chcete získat informace o vlastní cestě a umístění připnutí, použijte rozhraní Data Upload API.

Kontrola špendlíků a stavu nahrávání dat cesty

Pokud chcete zkontrolovat stav nahrávání dat a načíst jeho jedinečné ID ( udid ):

  1. V aplikaci Postman vyberte Nový.

  2. V okně Vytvořit nový vyberte Požadavek HTTP.

  3. Zadejte název požadavku, například GET Data Upload Status.

  4. Vyberte metodu GET HTTP.

  5. Zadejte status URL zkopírovaný kód do Upload špendlíků a dat cesty. Požadavek by měl vypadat jako následující adresa URL (nahraďte { Your-Azure-Maps-Primary-Subscription-key} vaším primárním klíčem předplatného):

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

  6. Vyberte Odeslat.

  7. V okně odpovědi vyberte kartu Hlavičky.

  8. Zkopírujte hodnotu klíče Resource-Location, což je resource location URL . obsahuje resource location URL jedinečný identifikátor ( ) prostředku balíčku pro udid kreslení.

    Zkopírujte adresu URL umístění prostředku.

Vykreslení nahraných funkcí na mapě

Vykreslení nahraných špendlíků a dat cest na mapě:

  1. V aplikaci Postman vyberte Nový.

  2. V okně Vytvořit nový vyberte Požadavek HTTP.

  3. Zadejte název požadavku, například GET Data Upload Status.

  4. Vyberte metodu GET HTTP.

  5. Zadejte následující adresu URL služby Render Service (nahraďte { vaším primárním klíčem předplatného a Your-Azure-Maps-Primary-Subscription-key} názvem udid udid nahraných dat):

    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. Služba vrátí následující obrázek:

    Vykreslení nahraných dat v obrázku statické mapy

Vykreslení mnohoúhelníku s barvou a neprůhlednosti

Poznámka

Postup v této části vyžaduje cenovou úroveň azure Mapy Gen 1 (S1) nebo Gen2.

Vzhled mnohoúhelníku můžete upravit pomocí modifikátorů stylu s parametrem cesty.

Vykreslení mnohoúhelníku s barvou a neprůhlednosti:

  1. V aplikaci Postman vyberte Nový.

  2. V okně Vytvořit nový vyberte Požadavek HTTP.

  3. Zadejte název požadavku, například GET Polygon.

  4. Vyberte metodu GET HTTP.

  5. Zadejte následující adresu URL služby Render Service (nahraďte { Your-Azure-Maps-Primary-Subscription-key} vaším primárním klíčem předplatného):

    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. Služba vrátí následující obrázek:

    Vykreslí neprůhledný mnohoúhelník.

Vykreslení kruhu a připínáčky s vlastními popisky

Poznámka

Postup v této části vyžaduje cenovou úroveň azure Mapy Gen 1 (S1) nebo Gen2.

Vzhled špendlíků můžete upravit přidáním modifikátorů stylu. Pokud například chcete, aby se připínáčky a jejich popisky zvětšují nebo zmenšují, použijte sc modifikátor "styl škálování". Tento modifikátor přebírá hodnotu, která je větší než nula. Hodnota 1 je standardní měřítko. Hodnoty větší než 1 zvětší špendlíky a hodnoty menší než 1 je zkrátí. Další informace o modifikátorech stylu najdete v tématu o parametrech cesty služby static image.

Vykreslení kruhu a připínáků s vlastními popisky:

  1. V aplikaci Postman vyberte Nový.

  2. V okně Vytvořit nový vyberte Požadavek HTTP.

  3. Zadejte název požadavku, například GET Polygon.

  4. Vyberte metodu GET HTTP.

  5. Zadejte následující adresu URL služby Render Service (nahraďte { Your-Azure-Maps-Primary-Subscription-key} vaším primárním klíčem předplatného):

    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. Vyberte Odeslat.

  7. Služba vrátí následující obrázek:

    Vykreslí kruh s vlastními špendlíky.

  8. Nyní změníme barvu špendlíků úpravou co modifikátoru stylu. Pokud se podíváte na hodnotu pins parametru ( pins=default|la15+50|al0.66|lc003C62|co002D62| ), uvidíte, že aktuální barva je #002D62 . Chcete-li změnit barvu na #41d42a , nahraďte #002D62 #41d42a . Nyní pins je parametr pins=default|la15+50|al0.66|lc003C62|co41D42A| . Požadavek vypadá jako následující adresa 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. Vyberte Odeslat.

  10. Služba vrátí následující obrázek:

    Vykreslí kružnici s aktualizovanými špendlíky.

Podobně můžete změnit, přidat a odebrat ostatní modifikátory stylu.

Další kroky