Bir raster eşlemesinde özel verileri işleme

  • Makale
  • Okumak için 4 dakika

Bu makalede, statik görüntü hizmetinin görüntü oluşturma işleviyle nasıl kullanılacağı açıklanır. Görüntü oluşturma işlevselliği, özel veri içeren statik raster kutucuğunun alınmasını destekler.

Aşağıda özel verilerin örnekleri verilmiştir:

  • Özel Pushpin 'ler
  • Etiketler
  • Geometri Yerpaylaşımları

İpucu

bir web sayfasında basit bir haritayı göstermek için, statik görüntü hizmetini kullanmak yerine Azure Haritalar web SDK 'sını kullanmak genellikle daha uygun maliyetli bir işlemdir. Web SDK 'Sı eşleme kutucukları kullanır; Kullanıcı haritayı yakınlaştırıp yakınlaşmadığı takdirde, genellikle harita yükü başına bir işlemin yalnızca bir bölümünü oluşturur. Azure Haritalar web SDK 'sı, kaydırma ve yakınlaştırmasını devre dışı bırakma seçeneklerine sahiptir. ayrıca, Azure Haritalar web SDK 'sı statik bir harita web hizmetinden daha zengin bir veri görselleştirme seçenekleri kümesi sağlar.

Önkoşullar

  1. Azure Haritalar hesabı oluşturma
  2. Birincil anahtar veya abonelik anahtarı olarak da bilinen birincil bir abonelik anahtarı alın.

Bu makale Postman uygulamasını kullanır, ancak farklı bir API geliştirme ortamı kullanabilirsiniz.

yer paylaşımlarını depolamak ve işlemek için Azure Haritalar Data Service apı 'lerini kullanacağız.

Pushpın 'leri etiketlerle ve özel bir görüntüyle işleme

Not

bu bölümdeki yordamda, gen 1 veya gen 2 fiyatlandırma katmanında bir Azure Haritalar hesabı gerekir. Azure Haritalar hesabı Gen 1 standart S0 katmanı, parametrenin yalnızca tek bir örneğini destekler pins . URL isteğinde belirtilen en fazla beş Pushpin (özel bir görüntüyle) oluşturmanızı sağlar.

Özel PIN ve etiketlerle statik görüntü al

Özel PIN ve etiketlere sahip bir statik görüntü almak için:

  1. Postman uygulamasında Yeni' yi seçin.

  2. Yeni oluştur penceresinde http isteği' ni seçin.

  3. İstek için statik görüntü al gibi bir istek adı girin.

  4. Get http yöntemini seçin.

  5. Aşağıdaki URL 'YI girin ({{ Your-Azure-Maps-Primary-Subscription-key} birincil abonelik anahtarınızla değiştirin):

    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. Gönder’i seçin.

  7. Hizmet aşağıdaki görüntüyü döndürür:

    Etiketi olan özel bir raptiye.

Upload sabitleme ve yol verileri

Not

bu bölümdeki yordamda bir Azure Haritalar hesabı gen 1 (S1) veya gen 2 fiyatlandırma katmanı gerekir.

Bu bölümde, Azure Map veri depolamaya yol ve veri iğnelemeyi yapacağız.

PIN 'leri ve yol verilerini karşıya yüklemek için:

  1. Postman uygulamasında Yeni' yi seçin.

  2. Yeni oluştur penceresinde http isteği' ni seçin.

  3. İstek için gönderi yolu ve PIN verileri gibi bir istek adı girin.

  4. HTTP Post yöntemini seçin.

  5. Aşağıdaki URL 'YI girin ({{ Your-Azure-Maps-Primary-Subscription-key} birincil abonelik anahtarınızla değiştirin):

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

  6. Gövde sekmesini seçin.

  7. Açılan listelerde, RAW ve JSON' ı seçin.

  8. Aşağıdaki JSON verilerini karşıya yüklenecek veriler olarak kopyalayın ve ardından gövde penceresine yapıştırın:

    {
  "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. Gönder’i seçin.

  10. Yanıt penceresinde üstbilgiler sekmesini seçin.

  11. İşlem-konum anahtarı değerini kopyalayın status URL . status URLBir sonraki bölümde karşıya yükleme isteğinin durumunu denetlemek için öğesini kullanacağız. status URLAşağıdaki biçime sahiptir:

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

İpucu

kendi yolunu ve pın konum bilgilerini almak için veri Upload apı'sini kullanın.

PIN 'leri ve yol verilerini karşıya yükleme durumunu denetleyin

Karşıya veri yükleme durumunu denetlemek ve benzersiz KIMLIĞINI () almak için udid :

  1. Postman uygulamasında Yeni' yi seçin.

  2. Yeni oluştur penceresinde http isteği' ni seçin.

  3. istek için veri al Upload durumu gibi bir istek adı girin.

  4. Get http yöntemini seçin.

  5. status URL Upload pın 'leri ve yol verilerinikopyalamak için buraya girin. İstek aşağıdaki URL gibi görünmelidir ({{ Your-Azure-Maps-Primary-Subscription-key} birincil abonelik anahtarınızla değiştirin):

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

  6. Gönder’i seçin.

  7. Yanıt penceresinde üstbilgiler sekmesini seçin.

  8. Olan Resource-location anahtarının değerini kopyalayın resource location URL . , resource location URL udid Çizim paketi kaynağının benzersiz tanımlayıcısını () içerir.

    Kaynak konumu URL 'sini kopyalayın.

Eşleme üzerinde karşıya yüklenen özellikleri işleme

Haritada karşıya yüklenen PIN 'leri ve yol verilerini işlemek için:

  1. Postman uygulamasında Yeni' yi seçin.

  2. Yeni oluştur penceresinde http isteği' ni seçin.

  3. istek için veri al Upload durumu gibi bir istek adı girin.

  4. Get http yöntemini seçin.

  5. İşleme hizmeti aşağıdaki URL 'yi girin ({ Your-Azure-Maps-Primary-Subscription-key} birincil abonelik anahtarınızla ve udid udid karşıya yüklenen verilerle değiştirin):

    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. Hizmet aşağıdaki görüntüyü döndürür:

    Karşıya yüklenen verileri statik harita görüntüsüne işleme.

Renk ve opaklık ile Çokgen işleme

Not

bu bölümdeki yordamda bir Azure Haritalar hesabı gen 1 (S1) veya gen 2 fiyatlandırma katmanı gerekir.

Yol parametresiylestil değiştiricilerini kullanarak bir çokgenin görünümünü değiştirebilirsiniz.

Renk ve opaklık içeren bir çokgen işlemek için:

  1. Postman uygulamasında Yeni' yi seçin.

  2. Yeni oluştur penceresinde http isteği' ni seçin.

  3. İstek için, Çokgen al gibi bir istek adı girin.

  4. Get http yöntemini seçin.

  5. İşleme hizmeti aşağıdaki URL 'yi girin ({{ Your-Azure-Maps-Primary-Subscription-key} birincil abonelik anahtarınızla değiştirin):

    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. Hizmet aşağıdaki görüntüyü döndürür:

    Donuk bir çokgen işleme.

Özel etiketlerle bir daire ve Pushpin işleme

Not

bu bölümdeki yordamda bir Azure Haritalar hesabı gen 1 (S1) veya gen 2 fiyatlandırma katmanı gerekir.

PIN 'lerin görünümünü stil değiştiricileri ekleyerek değiştirebilirsiniz. Örneğin, raptik ve etiketlerini daha büyük veya küçük hale getirmek için sc "stil Ölçeği" değiştiricisini kullanın. Bu değiştirici sıfırdan büyük bir değer alır. 1 değeri standart ölçeğe sahiptir. 1 ' den büyük değerler, PIN 'leri daha büyük yapar ve 1 ' den küçük değerler bunları daha küçük hale getirir. Stil değiştiriciler hakkında daha fazla bilgi için bkz. statik görüntü hizmeti yol parametreleri.

Özel etiketlerle bir daire ve Pushpin işlemek için:

  1. Postman uygulamasında Yeni' yi seçin.

  2. Yeni oluştur penceresinde http isteği' ni seçin.

  3. İstek için, Çokgen al gibi bir istek adı girin.

  4. Get http yöntemini seçin.

  5. İşleme hizmeti aşağıdaki URL 'yi girin ({{ Your-Azure-Maps-Primary-Subscription-key} birincil abonelik anahtarınızla değiştirin):

    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. Gönder’i seçin.

  7. Hizmet aşağıdaki görüntüyü döndürür:

    Özel itmeler ile daire işleme.

  8. Şimdi stil değiştiricisini değiştirerek pushpins rengini co değiştireceksiniz. parametresinin değerine () pins bakarsanız pins=default|la15+50|al0.66|lc003C62|co002D62| geçerli rengin olduğunu #002D62 görüyorsunuz. Rengini olarak değiştirmek için #41d42a yerine ile #002D62 #41d42a değiştiriz. Şimdi parametresi pins pins=default|la15+50|al0.66|lc003C62|co41D42A| olur. İstek aşağıdaki URL'ye benzer:

    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. Gönder’i seçin.

  10. Hizmet aşağıdaki görüntüyü döndürür:

    Güncelleştirilmiş itme tokaları olan bir daireyi işleme.

Benzer şekilde, diğer stil değiştiricilerini değiştirebilir, ekleyebilir ve kaldır modlandırıcılarını kaldırarak.

Sonraki adımlar