Data - List
使用擷取先前使用 數據上傳上傳的所有內容清單。
注意
Azure 地圖服務 數據服務淘汰
Azure 地圖服務 Data Service (v1 和 v2) 現在已被取代,將於 9/16/24 淘汰。 為了避免服務中斷,所有對數據服務的呼叫都必須更新,才能使用 9/16/24 Azure 地圖服務 Data Registry 服務。 如需詳細資訊,請參閱 如何建立數據登錄。
Data List
API 是 HTTP GET
要求,可讓呼叫者擷取先前使用數據上傳 API 上傳的所有內容清單。
提交清單要求
若要列出所有地圖數據內容,您將發出 GET
沒有其他參數的要求。
列出數據回應
數據清單 API 會以 json
格式傳回所有資料的完整清單。 回應包含每個資料資源的下列詳細資料:
udid - 數據資源的唯一數據識別碼。
location - 數據資源的位置。 在此位置上執行 HTTP
GET
要求以下載數據。
以下是傳回 udid
和 location
3 個數據資源的範例回應:
{
"mapDataList":
[
{
"udid": "9a1288fa-1858-4a3b-b68d-13a8j5af7d7c",
"location": "https://us.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://us.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://us.atlas.microsoft.com/mapData/7c1288fa-2058-4a1b-b68f-13a6h5af7d7c?api-version=1.0",
"sizeInBytes": 1650,
"uploadStatus": "Pending"
}]
}
GET https://{geography}.atlas.microsoft.com/mapData?api-version=2.0
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
geography
|
path | True |
string |
此參數會指定 Azure 地圖服務 Creator 資源所在的位置。 有效值為us和 eu。 |
api-version
|
query | True |
string |
Azure 地圖服務 API 的版本號碼。 |
要求標頭
名稱 | 必要 | 類型 | Description |
---|---|---|---|
x-ms-client-id |
string |
指定哪個帳戶與 Microsoft Entra ID 安全性模型搭配使用。 它代表 Azure 地圖服務 帳戶的唯一標識符,而且可以從 Azure 地圖服務 管理平面帳戶 API 擷取。 若要在 Azure 地圖服務 中使用 Microsoft Entra ID 安全性,請參閱下列文章以取得指引。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已成功完成列出數據要求。 回應本文包含所有先前上傳的數據清單。 |
|
Other Status Codes |
發生意外錯誤。 |
安全性
AADToken
這些是 Microsoft Entra OAuth 2.0 流程。 與 Azure 角色型存取控制配對時,可用來控制對 #DBCE63037FB3349039E09D4209AACCAC4 REST API 的存取。 Azure 角色型訪問控制可用來指定一或多個 Azure 地圖服務 資源帳戶或子資源的存取權。 任何使用者、群組或服務主體都可以透過內建角色或由一或多個許可權組成的自定義角色來授與存取權,以 Azure 地圖服務 REST API。
若要實作案例,建議您檢視 驗證概念。 總而言之,此安全性定義會透過能夠針對特定 API 和範圍進行訪問控制的物件,提供將應用程式模型化 () 的解決方案。
備註
- 此安全性定義需要使用
x-ms-client-id
標頭來指出應用程式要求存取權 Azure 地圖服務 資源。 這可以從 地圖管理 API 取得。
Authorization URL
專屬於 Azure 公用雲端實例。 主權雲端具有唯一的授權 URL 和 Microsoft Entra ID 設定。
* 透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API,從 Azure 管理平面設定 Azure 角色型存取控制。
* Azure 地圖服務 Web SDK 的使用方式允許針對多個使用案例設定應用程式設定。
- 如需 Microsoft 身分識別平台 的詳細資訊,請參閱 Microsoft 身分識別平台 概觀。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名稱 | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
這是在 Azure 入口網站 或使用PowerShell、CLI、Azure SDK 或 REST API Create Azure 地圖服務 帳戶時所佈建的共享密鑰。
使用此金鑰,任何應用程式都可以存取所有 REST API。 換句話說,此金鑰可作為發行所在帳戶中的主要金鑰。
對於公開的應用程式,我們建議使用機密用戶端應用程式方法來存取 Azure 地圖服務 REST API,以便安全地儲存您的密鑰。
Type:
apiKey
In:
query
SAS Token
這是透過 Azure 管理平面透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API,從 Azure 地圖服務 資源上的列出 SAS 作業建立的共用存取簽章令牌。
使用此令牌時,任何應用程式都有權使用 Azure 角色型訪問控制進行存取,並更精細地控制到期、速率和區域 (特定令牌的使用) 。 換句話說,SAS 令牌可用來允許應用程式以比共用密鑰更安全的方式來控制存取。
對於公開的應用程式,我們建議在 地圖帳戶資源 上設定允許的來源特定清單,以限制轉譯濫用,並定期更新 SAS 令牌。
Type:
apiKey
In:
header
範例
List all the previously uploaded data
Sample Request
GET https://us.atlas.microsoft.com/mapData?api-version=2.0
Sample Response
{
"mapDataList": [
{
"udid": "f6495f62-94f8-0ec2-c252-45626f82fcb2",
"location": "https://us.atlas.microsoft.com/mapData/f6495f62-94f8-0ec2-c252-45626f82fcb2?api-version=1.0",
"sizeInBytes": 29920,
"uploadStatus": "Completed"
},
{
"udid": "8b1288fa-1958-4a2b-b68e-13a7i5af7d7c",
"location": "https://us.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://us.atlas.microsoft.com/mapData/7c1288fa-2058-4a1b-b68f-13a6h5af7d7c?api-version=1.0",
"sizeInBytes": 1650,
"uploadStatus": "Pending"
}
]
}
定義
名稱 | Description |
---|---|
Data |
上傳內容的數據格式。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Map |
數據的詳細資訊。 |
Map |
數據清單 API 的回應模型。 傳回所有先前上傳數據的清單。 |
Upload |
內容的目前上傳狀態。 |
DataFormat
上傳內容的數據格式。
名稱 | 類型 | Description |
---|---|---|
dwgzippackage |
string |
包含 DWG 檔案的 ZIP 套件。 |
geojson |
string |
GeoJSON 是以 JSON 為基礎的地理空間數據交換格式。 |
zip |
string |
壓縮的數據格式。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
錯誤物件。 |
MapData
數據的詳細資訊。
名稱 | 類型 | Description |
---|---|---|
dataFormat |
上傳內容的數據格式。 |
|
description |
string |
目前的描述。 |
location |
string |
數據的位置。 在此位置上執行 HTTP |
sizeInBytes |
integer |
以位元組為單位的內容大小。 |
udid |
string |
數據的唯一數據識別碼。 |
uploadStatus |
內容的目前上傳狀態。 |
MapDataListResult
數據清單 API 的回應模型。 傳回所有先前上傳數據的清單。
名稱 | 類型 | Description |
---|---|---|
mapDataList |
Map |
所有先前上傳數據的清單。 |
UploadStatus
內容的目前上傳狀態。
名稱 | 類型 | Description |
---|---|---|
Completed |
string |
上傳驗證和處理已完成 |
Failed |
string |
上傳驗證和/或處理失敗 |
Pending |
string |
正在處理上傳 |