Data - Upload
Azure Haritalar hesabına veri içeriği yüklemek için kullanın.
Not
Azure Haritalar Veri hizmetinin kullanımdan kaldırılması
Azure Haritalar Veri hizmeti ( hem v1 hem de v2) artık kullanım dışıdır ve 16.09.24 tarihinde kullanımdan kaldırılacaktır. Hizmet kesintilerini önlemek için Veri hizmetine yapılan tüm çağrıların 16.09.24'e kadar Azure Haritalar Veri Kayıt Defteri hizmetini kullanacak şekilde güncelleştirilmesi gerekir. Daha fazla bilgi için bkz. Veri kayıt defteri oluşturma.
Data Upload
API, çağıranın Azure Haritalar hizmetine veri içeriği yüklemesine olanak tanıyan bir HTTP POST
isteğidir.
Bu API'yi, Azure Haritalar Coğrafi Sınırlama Hizmetimizde kullanmak üzere bir Geofences GeoJSON
koleksiyonunu biçiminde karşıya yükleme gibi bir senaryoda kullanabilirsiniz.
Önemli
Bu özelliği kullanarak önizleme yasal koşullarını kabul etmiş olursunuz. Ek ayrıntılar için Bkz. Önizleme Ek Koşulları .
Karşıya Yükleme İsteği Gönder
İçeriğinizi karşıya yüklemek için bir POST
istek kullanacaksınız. İstek gövdesi karşıya yüklenecek verileri içerir. Sorgu dataFormat
parametresi verilerin biçimini, sorgu parametresi ise verilerin dataSharingLevel
paylaşım düzeyini içerebilir. Üst Content-Type
bilgi, verilerin içerik türüne ayarlanır.
Örneğin, bir coğrafi GeoJSON
konumlar koleksiyonunu biçiminde karşıya yüklemek için istek gövdesini coğrafi konum içeriğine ayarlayın. Sorgu parametresini dataFormat
geojson olarak ayarlayın ve üst bilgiyi aşağıdaki medya türlerinden birine ayarlayın Content-Type
:
application/json
application/vnd.geo+json
application/octet-stream
Burada, merkez noktası ve yarıçap kullanarak daire geometrisi olarak temsil edilen basit bir Geofence'i karşıya yüklemek için örnek bir istek gövdesi verilmiştir. Aşağıdaki örnek içindedir GeoJSON
:
{
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [-122.126986, 47.639754]
},
"properties": {
"geometryId": "001",
"radius": 500
}
}]
}
Veri Yükleme API'si uzun süre çalışan bir işlem gerçekleştirir.
Veri Yükleme Sınırları
Lütfen şu anda her Azure Haritalar hesabının bir veri depolama sınırı olduğunu unutmayın. Depolama sınırına ulaşıldıktan sonra, tüm yeni karşıya yükleme API'leri bir 409 Conflict
http hata yanıtı döndürür. Eski/kullanılmayan içeriği silmek ve yeni karşıya yüklemeler için alan oluşturmak için her zaman Veri Silme API'sini kullanabilirsiniz.
POST https://{geography}.atlas.microsoft.com/mapData?api-version=2.0&dataFormat={dataFormat}
POST https://{geography}.atlas.microsoft.com/mapData?api-version=2.0&description={description}&dataFormat={dataFormat}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
geography
|
path | True |
string |
Bu parametre, Azure Haritalar Oluşturucu kaynağının nerede bulunduğunu belirtir. Geçerli değerler: biz ve AB. |
api-version
|
query | True |
string |
Azure Haritalar API'sinin sürüm numarası. |
data
|
query | True |
Karşıya yüklenen içeriğin veri biçimi. |
|
description
|
query |
string |
Karşıya yüklemeye verilecek açıklama. |
İstek Başlığı
Media Types: "application/json", "application/octet-stream"
Name | Gerekli | Tür | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID güvenlik modeliyle birlikte hangi hesabın kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar'da Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın. |
İstek Gövdesi
Media Types: "application/json", "application/octet-stream"
Name | Tür | Description |
---|---|---|
UploadContent |
object |
Karşıya yüklenecek içerik. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
İşlem çalışıyor veya tamamlandı. İşlem başarılı olursa, sonucun yolunu elde etmek için Resource-Location üst bilgisini kullanın. Üst Bilgiler Resource-Location: string |
|
202 Accepted |
İstek Kabul Edildi: İstek işlenmek üzere kabul edildi. Durumu almak için lütfen Operation-Location Üst Bilgisindeki URL'yi kullanın. Üst Bilgiler Operation-Location: string |
|
Other Status Codes |
Azure Haritalar hesabında veri depolama sınırına ulaşılır. Eski/kullanılmayan içeriği silmek ve yeni karşıya yüklemeler için alan oluşturmak için her zaman Veri Silme API'sini kullanabilirsiniz. |
|
Other Status Codes |
Beklenmeyen bir hata oluştu. |
Güvenlik
AADToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişimi belirtmek için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna 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çin kimlik 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ı modellemeye yönelik bir çözüm sağlar.
Notlar
- Bu güvenlik tanımı, uygulamanın erişim isteğinde
x-ms-client-id
bulunduğu Azure Haritalar kaynağını belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir.
Authorization URL
, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır.
* 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ı, birden çok kullanım örneği için bir uygulamanın 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 | https://atlas.microsoft.com/.default |
subscription-key
Bu, Azure portalında 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.
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 Gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi öneririz.
Tür:
apiKey
İçinde:
query
SAS Token
Bu paylaşılan erişim imzası belirteci, Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure Haritalar kaynağındaki Sas Listeleme işleminden oluşturulur.
Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. 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, uygunsuz işlemeyi sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmanızdır.
Tür:
apiKey
İçinde:
header
Örnekler
Upload GeoJSON data containing geometries that represent a collection of geofences
Örnek isteği
POST https://us.atlas.microsoft.com/mapData?api-version=2.0&dataFormat=geojson
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.126986,
47.639754
]
},
"properties": {
"geometryId": "001",
"radius": 500
}
}
]
}
Örnek yanıt
Resource-Location: https://us.atlas.microsoft.com/mapData/3e36b996-f6d1-b068-0fcb-dd6b014c3447?api-version=2.0
{
"operationId": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
"created": "2021-04-20T22:43:14.9401559+00:00",
"status": "Succeeded"
}
Operation-Location: https://us.atlas.microsoft.com/mapData/operations/{udid}?api-version=2.0
Access-Control-Expose-Headers: Operation-Location
{
"error": {
"code": "409 Conflict",
"message": "The data storage limit is reached on the Azure Maps account. You can always use the Data Delete API to delete old/unused content and create space for new uploads."
}
}
Tanımlar
Name | Description |
---|---|
Data |
Karşıya yüklenen içeriğin veri biçimi. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Long |
Long-Running İşlemler API'sinin yanıt modeli. |
Lro |
İsteğin durum durumu. |
DataFormat
Karşıya yüklenen içeriğin veri biçimi.
Name | Tür | Description |
---|---|---|
dwgzippackage |
string |
DWG dosyasını içeren ZIP paketi. |
geojson |
string |
GeoJSON , JSON tabanlı bir jeo-uzamsal veri değişim biçimidir. |
zip |
string |
Sıkıştırılmış veri biçimi. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
LongRunningOperationResult
Long-Running İşlemler API'sinin yanıt modeli.
Name | Tür | Description |
---|---|---|
created |
string |
Oluşturulan zaman damgası. |
error |
Hata ayrıntısı. |
|
operationId |
string |
Bu uzun süre çalışan işlemin kimliği. |
status |
İsteğin durum durumu. |
|
warning |
Hata ayrıntısı. |
LroStatus
İsteğin durum durumu.
Name | Tür | Description |
---|---|---|
Failed |
string |
İstekte bir veya daha fazla hata var. |
NotStarted |
string |
İstek henüz işlemeye başlamadı. |
Running |
string |
İstek işlemeye başladı. |
Succeeded |
string |
İstek başarıyla tamamlandı. |