Render - Get Copyright Caption

Hizmet:

Maps

API Sürümü:

2024-04-01

Kutucuk işlenirken kullanılacak telif hakkı bilgilerini almak için kullanın.
Get Copyright Caption API,İşleme hizmetinden istenen kutucuklarla kullanılacak telif hakkı bilgilerini sunmak üzere tasarlanmış bir HTTP GET isteğidir. Haritanın tamamı için temel bir telif hakkına ek olarak, bazı ülkeler/bölgeler için belirli telif hakkı gruplarına hizmet verebilir.

Harita isteği için telif haklarına alternatif olarak, sağlayıcı bilgilerini haritada görüntülemek için açıklamalı alt yazılar da döndürebilir.

GET {endpoint}/map/copyright/caption/{format}?api-version=2024-04-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string
format	path	True	ResponseFormat	Yanıtın istenen biçimi. Değer json veya xml olabilir.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İ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	CopyrightCaption	İ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. Herhangi bir kullanıcı, grup veya hizmet prensibi, yerleşik bir rol veya bir veya daha fazla REST API'si Azure Haritalar izninden oluşan özel bir rol aracılığıyla erişim hakkı alabilir.\n\nSenaryoları uygulamak için authentication concepts incelemenizi öneririz. Özetle, bu güvenlik tanımı, belirli API'ler ve kapsamlar üzerinde erişim kontrolü yapabilen nesneler aracılığıyla uygulama(lar)ın modellenmesi için bir çözüm sunar.\n\n#### Notlar\n* Bu güvenlik tanımı c0x-ms-client-id başlığının kullanılmasını gerektirir; bu başlık uygulamanın hangi Azure Haritalar kaynağa erişim talep ettiğini belirtir. Bu, Maps yönetim API üzerinden alınabilir.\n* \nAuthorization URL Azure genel bulut örneğine özgüdür. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir. \n* \nAzure rol tabanlı erişim kontrolü, Azure yönetim düzleminden Azure portal, PowerShell, CLI, Azure SDK’ları veya REST API'leri aracılığıyla yapılandırılır.\n* \nAzure Haritalar Web SDK birden fazla kullanım durumu için bir uygulamanın yapılandırma tabanlı kurulumuna olanak tanır.\n* Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu 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 Bir Azure Haritalar hesabı oluşturduğunuzda veya PowerShell, CLI, Azure SDK’ları veya REST API kullandığınızda sağlanan paylaşılan bir anahtardır.\n\n Bu anahtarla, herhangi bir uygulama tüm REST API'lerine erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.\n\n Kamuya açık uygulamalar için, anahtarınızın güvenli bir şekilde saklanabilmesi için confidential istemci uygulamaları yaklaşımını kullanmanızı öneririz; böylece Azure Haritalar anahtarınız güvenli bir şekilde saklanabilir.

Tür: apiKey
İçinde: header

SAS Token

Bu, Azure Haritalar kaynağı üzerindeki List SAS işleminden Azure portal, PowerShell, CLI, Azure SDK’ları veya REST API'leri aracılığıyla Azure yönetim düzlemi üzerinden oluşturulan paylaşılan erişim imza belirtekenidir.\n\n Bu token ile herhangi bir uygulamanın Azure ile erişim yetkisi verilir rol tabanlı erişim kontrolleri ve belirli tokenın kullanım süresi, oranı ve kullanım bölgesi(ler)ine kadar ince denli kontrol. Başka bir deyişle, SAS Token, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde kontrol etmesini sağlamak için kullanılabilir.\n\n Kamuya açık uygulamalar için, önerimiz, render kötüye kullanımını sınırlamak ve SAS Token'ı düzenli olarak yenilemek için Map hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmak ve düzenli olarak yenilemektir.

Tür: apiKey
İçinde: header

Örnekler

Successful Copyright Caption Request

Örnek isteği

HTTP

GET {endpoint}/map/copyright/caption/json?api-version=2024-04-01

Örnek yanıt

Durum kodu:

200

{
  "copyrightsCaption": "© 1992 - 2022 TomTom.",
  "formatVersion": "0.0.1"
}

Tanımlar

Name	Description
CopyrightCaption	Bu nesne başarılı bir telif hakkı çağrısından döndürülür
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.).
ResponseFormat	Yanıtın istenen biçimi. Değer json veya xml olabilir.

CopyrightCaption

Nesne

Bu nesne başarılı bir telif hakkı çağrısından döndürülür

Name	Tür	Description
copyrightsCaption	string	Telif Hakkı Başlığı özelliği
formatVersion	string	Biçim Sürümü özelliği

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.

ResponseFormat

Numaralandırma

Yanıtın istenen biçimi. Değer json veya xml olabilir.

Değer	Description
json	JavaScript Nesne Gösterimi Veri Değişim Biçimi
xml	Genişletilebilir biçimlendirme dili