Render - Get Map Attribution

Hizmet:
Maps
API Sürümü:
2024-04-01

Harita telif hakkı ilişkilendirme bilgilerini almak için kullanın.
Get Map Attribution API'si, kullanıcıların kutucuk kümesinin bir bölümü için harita telif hakkı ilişkilendirme bilgileri istemesine olanak tanır.

GET {endpoint}/map/attribution?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&bounds={bounds}

URI Parametreleri

Name İçinde Gerekli Tür Description
endpoint
 path True

string (uri)

Azure Haritalar service hostname. Azure açık bulut için https://atlas.microsoft.com kullanın. Belirli bir Azure Haritalar coğrafyası veya egemen bir bulutu hedeflemek için Azure Haritalar coğrafi kapsam bkz.
api-version
 query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.
bounds
 query True

number[]

Sınırlayıcı kutunun dikdörtgen alanını temsil eden dize. bounds parametresi, WGS84 boylamı ve güneybatı köşesinin enlemi ve ardından WGS84 boylamı ve kuzeydoğu köşesinin enlemi ile 4 sınırlayıcı kutu koordinatları ile tanımlanır. Dize şu biçimde sunulur: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].
tilesetId
 query True

TilesetID

Kutucuk kümesi, önceden ayarlanmış yakınlaştırma düzeylerinde kare kutucuklardan oluşan tekdüzen bir kılavuza ayrılmış raster veya vektör verilerinden oluşan bir koleksiyondur. Her kutucuk kümesinin istekte bulunurken kullanabileceği bir tilesetId vardır. Azure Haritalar tarafından sağlanan kullanıma hazır tilesetler aşağıda listelenmiştir. Örneğin, microsoft.base.
zoom
 query True

integer (int32)

İstenen harita ilişkilendirmesi için yakınlaştırma düzeyi.

İstek Başlığı

Name Gerekli Tür Description
x-ms-client-id

string

Microsoft Entra ID güvenlik modeliyle kullanılmak üzere tasarlanmış hesabı gösterir. Azure Haritalar hesabı için bu benzersiz ID, Azure Haritalar yönetim düzlemi Hesap API'dan alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar içinde yönetin.

Yanıtlar

Name Tür Description
200 OK

MapAttribution

İstek başarılı oldu.
Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

AadToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim kontrolüyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim belirlemek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak içinkimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemek için bir çözüm sağlar.

Note

  • Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.
  • Authorization URL, Azure genel bulut örneğine özgüdür. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir.
  • Azure rol tabanlı erişim denetimi Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır.
  • Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.
  • Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformuna genel bakış.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
https://atlas.microsoft.com/.default

subscription-key

Bu, Azure portalında Azure Haritalar hesabı oluşturma veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.

Tür: apiKey
İçinde: header

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portalı, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağı Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.

Tür: apiKey
İçinde: header

Örnekler

Successful Attribution Request

Örnek isteği

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.57949,-122.247157,47.668372

Örnek yanıt

Durum kodu:
200 
{
  "copyrights": [
    "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>"
  ]
}

Tanımlar

Name Description
ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.
ErrorDetail

Hata ayrıntısı.
ErrorResponse

Tüm Azure Resource Manager API'lerinin başarısız işlemler için hata detaylarını döndürmesi için yaygın hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
MapAttribution

Kutucuk kümesinin istenen bölümü için telif hakkı atfı.
TilesetID

Kutucuk kümesi, önceden ayarlanmış yakınlaştırma düzeylerinde kare kutucuklardan oluşan tekdüzen bir kılavuza ayrılmış raster veya vektör verilerinden oluşan bir koleksiyondur. Her kutucuk kümesinin istekte bulunurken kullanabileceği bir tilesetId vardır. Azure Haritalar tarafından sağlanan kullanıma hazır tilesetler aşağıda listelenmiştir. Örneğin, microsoft.base.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

Ek bilgiler.
type

string

Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.
code

string

Hata kodu.
details

ErrorDetail[]

Hata ayrıntıları.
message

string

Hata iletisi.
target

string

Hata hedefi.

ErrorResponse

Nesne

Tüm Azure Resource Manager API'lerinin başarısız işlemler için hata detaylarını döndürmesi için yaygın hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).

Name Tür Description
error

ErrorDetail

Hata nesnesi.

MapAttribution

Nesne

Kutucuk kümesinin istenen bölümü için telif hakkı atfı.

Name Tür Description
copyrights

string[]

Telif hakkı dizelerinin listesi.

TilesetID

Numaralandırma

Kutucuk kümesi, önceden ayarlanmış yakınlaştırma düzeylerinde kare kutucuklardan oluşan tekdüzen bir kılavuza ayrılmış raster veya vektör verilerinden oluşan bir koleksiyondur. Her kutucuk kümesinin istekte bulunurken kullanabileceği bir tilesetId vardır. Azure Haritalar tarafından sağlanan kullanıma hazır tilesetler aşağıda listelenmiştir. Örneğin, microsoft.base.

Değer Description
microsoft.base

Temel harita, yolların, doğal ve yapay özelliklerin yanı sıra bu özelliklerin etiketlerini bir vektör kutucuğunda görüntüleyen standart bir haritadır.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: vektör (pbf).
microsoft.base.labels

Bir vektör kutucuğunda yollar, doğal ve yapay özellikler için etiketleri görüntüler.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: vektör (pbf).
microsoft.base.hybrid

Yol, sınır ve etiket verilerini bir vektör kutucuğunda görüntüler.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: vektör (pbf).
microsoft.terra.main

Gölgeli kabartma ve terra katmanları.

0 ile 6 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.base.road

Ana stilimizle tüm katmanlar.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.base.darkgrey

Koyu gri stilimizle tüm katmanlar.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.base.labels.road

Verileri ana stilimizde etiketle.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.base.labels.darkgrey

Verileri koyu gri stilimizde etiketle.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.base.hybrid.road

Ana stilimizde yol, sınır ve etiket verileri.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.base.hybrid.darkgrey

Koyu gri stilimizde yol, sınır ve etiket verileri.

0 ile 22 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.imagery

Uydu veya havadan görüntülerin birleşimi.

1 ile 19 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.weather.radar.main

Hava durumu radarı kutucukları. Yağmur, kar, buz ve karışık koşullar gibi en son hava durumu radar görüntüleri. Azure Haritalar Hava Durumu hizmeti kapsamı hakkında daha fazla bilgi için Azure Haritalar hava durumu hizmetleri kapsamı adresine bakınız. Radar verileri hakkında daha fazla bilgi için Weather services in Azure Haritalar sayfasına bakınız.

0 ile 15 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.weather.infrared.main

Hava kızılötesi kutucuklar. En son Kızılötesi Uydu görüntüleri bulutları sıcaklıklarına göre gösterir. Daha fazla bilgi için bkz. Azure Haritalar hava hizmetleri kapsamı. Geri gönderilen uydu verileri hakkında daha fazla bilgi için bkz. Weather services in Azure Haritalar.

0 ile 15 arasında yakınlaştırma düzeylerini destekler. Biçim: raster (png).
microsoft.traffic.absolute

vektördeki mutlak trafik kutucukları
microsoft.traffic.absolute.main

ana stilimizde raster mutlak trafik kutucukları.
microsoft.traffic.relative

vektördeki göreli trafik kutucukları
microsoft.traffic.relative.main

ana stilimizde raster'daki göreli trafik kutucukları.
microsoft.traffic.relative.dark

göreli trafik kutucukları koyu stilimizde raster.
microsoft.traffic.delay

vektördeki trafik kutucukları
microsoft.traffic.delay.main

ana stilimizde raster'da trafik kutucukları
microsoft.traffic.reduced.main

ana stilimizde raster'da azaltılmış trafik kutucukları
microsoft.traffic.incident

vektördeki olay kutucukları