Data

  • Başvuru
Service:
Maps
API Version:
1.0

Operations

Delete Preview

Veri silme API 'SI

Uygulama hedefi: S1 fiyatlandırma katmanı.

Bu API, çağıranın daha önce karşıya yüklenmiş bir veri içeriğini silmesine izin verir.

bu apı 'yi, daha önce Azure Haritalar bölge oluşturma hizmeti'nde kullanmak üzere veri Upload apı 'si kullanılarak karşıya yüklenen bölge 'leri kaldırma gibi bir senaryoda kullanabilirsiniz. Bu API 'YI Ayrıca, eski/kullanılmamış karşıya yüklenen içeriği silmek ve yeni içerik için alan oluşturmak üzere de kullanabilirsiniz.

Silme Isteği gönder

İçeriğinizi silmek için, DELETE yolun Silinecek verilerin bulunduğu bir istek verirsiniz udid .

örneğin, daha önce Upload apı kullanılarak karşıya yüklenen bölge bir koleksiyonunu silmek için, udid udid önceki apı yanıtında alınan verilerin yolundaki parametresini ayarlayın.

Veri yanıtı silme

Veri 204 No Content kaynağı başarıyla silinmişse, Data Delete API 'si boş bir gövdeye sahip BIR http yanıtı döndürür.

400 Bad RequestGeçirilen veri kaynağı bulunmazsa BIR http hatası yanıtı döndürülür udid .
Download Preview

Veri Indirme API 'SI

Uygulama hedefi: S1 fiyatlandırma katmanı.

Bu API, çağıranın daha önce karşıya yüklenmiş bir veri içeriğini indirmesini sağlar.

bu apı 'yi, Azure Haritalar geoftgservice'te kullanmak üzere daha önce veri Upload apı 'si kullanılarak karşıya yüklenen mevcut bölge kolekbir koleksiyonunu karşıdan yükleme gibi bir senaryoda kullanabilirsiniz.

Indirme Isteği gönder

İçeriğinizi indirmek için, GET yolun indirilecek verilerin bulunduğu bir istek kullanacaksınız udid . İsteğe bağlı olarak, Accept veri yanıtı için bir tercih belirtmek üzere bir üst bilgi de geçirebilirsiniz Content-Type .
örneğin, daha önce Upload apı kullanılarak karşıya yüklenen bir bölge topluluğunu indirmek için, udid udid önceki apı yanıtında alınan verilerin yolundaki parametresini ayarlayın ve Accept üstbilgiyi aşağıdaki medya türlerinden birine ayarlayın:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Veri yanıtı indirme

200 OK udid Yanıt gövdesinin, veri kaynağının içeriğini içermesi halinde, geçilen veri kaynağı bulunursa, indirme API 'SI bir http yanıtı döndürür.
400 Bad RequestGeçirilen veri kaynağı bulunmazsa BIR http hatası yanıtı döndürülür udid .

aşağıda GeoJSON , daha önce Upload apı 'si kullanılarak karşıya yüklenmiş olarak temsil edilen basit bir bölge için örnek yanıt gövdesi verilmiştir: 

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}
List Preview

Veri listesi API 'SI

Uygulama hedefi: S1 fiyatlandırma katmanı.

bu apı, çağıran tarafından daha önce karşıya yüklenen tüm içeriklerin bir listesini veri Upload apı 'sikullanılarak getirmeye olanak tanır.

Liste Isteği gönder

Tüm harita veri içeriğinizi listelemek için GET ek parametre olmadan bir istek verirsiniz.

Veri yanıtını listeleme

Veri listesi API 'SI, tüm verilerin biçimdeki tüm listesini döndürür json . Yanıt, her bir veri kaynağı için aşağıdaki ayrıntıları içerir:

uıdıd-veri kaynağı için benzersiz veri kimliği.

konum-veri kaynağının konumu. GETVerileri indirmek için bu konumda BIR http yürütün.

Aşağıda udid 3 veri kaynağını döndüren örnek bir yanıt verilmiştir location :


{
    "mapDataList": 
    [
        {
            "udid": "9a1288fa-1858-4a3b-b68d-13a8j5af7d7c",
            "location": "https://atlas.microsoft.com/mapData/9a1288fa-1858-4a3b-b68d-13a8j5af7d7c?api-version=1.0",
            "sizeInBytes": 29920,
            "uploadStatus": "Completed"
        },
        {
            "udid": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
            "location": "https://atlas.microsoft.com/mapData/8b1288fa-1958-4a2b-b68e-13a7i5af7d7c?api-version=1.0",
            "sizeInBytes": 1339,
            "uploadStatus": "Completed"
        },
        {
            "udid": "7c1288fa-2058-4a1b-b68f-13a6h5af7d7c",
            "location": "https://atlas.microsoft.com/mapData/7c1288fa-2058-4a1b-b68f-13a6h5af7d7c?api-version=1.0",
            "sizeInBytes": 1650,
            "uploadStatus": "Pending"
        }]
}

Update Preview

Veri güncelleştirme API 'SI

Uygulama hedefi: S1 fiyatlandırma katmanı.

Veri güncelleştirme API 'SI, çağıranın daha önce karşıya yüklenmiş bir veri içeriğini güncelleştirmesine izin verir.

Bu API 'yi, var olan bölge koleksiyonundan veya bu koleksiyondan bölge ekleme veya kaldırma gibi bir senaryoda kullanabilirsiniz. bölge alanları, Azure Haritalar bölge sınırlaması hizmetindekullanılmak üzere veri Upload apı 'sikullanılarak karşıya yüklenir.

Güncelleştirme API 'sinin var olan veri içeriğini değiştirip geçersiz kılacağına lütfen unutmayın.

Güncelleştirme Isteği gönder

İçeriğinizi güncelleştirmek için bir PUT istek kullanırsınız. İstek gövdesi, mevcut verilerin yerini alacak yeni verileri içerir. Content-TypeÜst bilgi, verilerin içerik türüne ayarlanacak ve bu yolda udid güncelleştirilecek verilerin bulunduğu yol.

örneğin, daha önce Upload apı kullanılarak karşıya yüklenen bölge topluluğunu güncelleştirmek için, yeni bölge içeriğini istek gövdesine yerleştirin. udid udid Yükleme API yanıtında daha önce alınan verilerin yolundaki parametresini ayarlayın. Ve Content-Type üst bilgisini aşağıdaki medya türlerinden birine ayarlayın:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Bir basit bölge güncelleştirmesine yönelik örnek bir istek gövdesi aşağıda verilmiştir. Bir orta nokta ve yarıçap kullanan bir daire geometrisi olarak temsil edilir. Aşağıdaki örnek GeoJSON :

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}

Daha önce karşıya yüklenen bölge sayısı 100 milyon yarıçap içeriyordu. Yukarıdaki istek, 500 milyon olarak güncelleştirilecek.

Veri güncelleştirme API 'SI uzun süre çalışan bir istekgerçekleştirir.

Veri güncelleştirme limitleri

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ığında, tüm yeni karşıya yükleme API çağrıları bir 409 Conflict http hata yanıtı döndürür. Eski/kullanılmayan içerikleri silmek ve yeni karşıya yüklemeler için alan oluşturmak üzere her zaman veri SILME API 'sini kullanabilirsiniz.
Upload Preview

veri Upload apı 'si

Uygulama hedefi: S1 fiyatlandırma katmanı.

veri Upload apı 'si, çağıranın Azure Haritalar hizmetine veri içeriği yüklemesine olanak tanır. bu apı 'yi GeoJSON , Azure Haritalar bölge sınırlaması hizmeti'nde kullanılmak üzere, bir bölge koleksiyonunu bir biçimde karşıya yükleme gibi bir senaryoda kullanabilirsiniz.

Upload isteği gönder

İçeriğinizi karşıya yüklemek için bir POST istek kullanacaksınız. İstek gövdesi yüklenecek verileri içerecektir. Content-TypeÜst bilgi, verilerin içerik türüne ayarlanır.

Örneğin, bir bölge koleksiyonunu biçiminde bir koleksiyon yüklemek için GeoJSON , istek gövdesini bölge içeriği olarak ayarlayın. dataFormatSorgu parametresini geojson olarak ayarlayın ve Content-Type üstbilgiyi aşağıdaki medya türlerinden biri olarak ayarlayın:

  • application/json
  • application/vnd.geo+json
  • application/octet-stream

Bir orta nokta ve yarıçap kullanarak bir daire geometrisi olarak temsil edilen basit bölge listesini yüklemek için örnek bir istek gövdesi aşağıda verilmiştir. Aşağıdaki örnek GeoJSON :

{
    "type": "FeatureCollection",
    "features": [{
        "type": "Feature",
        "geometry": {
            "type": "Point",
            "coordinates": [-122.126986, 47.639754]
        },
        "properties": {
            "geometryId": "001",
            "radius": 500
        }
    }]
}

veri Upload apı 'si uzun süredir çalışan bir istekgerçekleştirir.

veri Upload 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ığında, tüm yeni karşıya yükleme API çağrıları bir 409 Conflict http hata yanıtı döndürür. Eski/kullanılmayan içerikleri silmek ve yeni karşıya yüklemeler için alan oluşturmak üzere her zaman veri SILME API 'sini kullanabilirsiniz.