Elevation - Post Data For Points

查詢多個點的提高許可權資料。
適用于: S1 定價層。 點的 Post 資料 API 提供多個點的提高許可權資料。 點是以 lat/lon 座標格式來定義。 只有當您想要在要求中傳遞多個點時,才使用 POST 端點。 如果您想要將單一座標傳遞到 API,請使用「 取得點數的資料」 api

POST https://atlas.microsoft.com/elevation/point/json?api-version=1.0
POST https://atlas.microsoft.com/elevation/point/json?subscription-key={subscription-key}&api-version=1.0

URI 參數

Name In Required Type Description
format
path True

所需的回應格式。 僅支援 json 格式。

api-version
query True
  • string

Azure 地圖服務 API 的版本號碼。 目前的版本為1。0

subscription-key
query
  • string

從 Azure 地圖帳戶提供的其中一個 Azure 地圖服務金鑰。 如需如何管理驗證的詳細資訊,請參閱這 篇文章

要求標頭

Name Required Type Description
x-ms-client-id
  • string

指定要搭配 Azure AD 的安全性模型使用的帳戶。 它代表 Azure 地圖服務帳戶的唯一識別碼,而且可以從 Azure 地圖服務管理平面帳戶 API 中取出。 若要在 Azure 地圖服務中使用 Azure AD 安全性,請參閱下列 文章 以取得指導方針。

要求本文

Name Type Description
pointsRequestBody

點清單的字串表示。 點是以 lat/lon WGS84 座標參考系統格式來定義。 清單中的每個點都應以管線 ( ' | ' 分隔) 字元。 POST 要求中可以要求的點數範圍是從2到2000。 提高許可權資料的解析度將會是單一點的最高,且如果多個點彼此分離,將會降低。

回應

Name Type Description
200 OK

確定

400 Bad Request

不正確的要求:有一或多個參數未正確指定或互斥。

401 Unauthorized

因為訂用帳戶金鑰無效或 Azure Active Directory 持有人權杖無效,所以拒絕存取。 請務必為有效的 Azure 訂用帳戶和地圖資源提供有效的金鑰。 否則,請驗證 WWW 驗證 標頭中的錯誤碼,以及所提供的 AAD 持有人權杖的描述。

Headers

  • WWW-Authenticate: string
403 Forbidden

許可權、容量或驗證問題。

404 Not Found

找不到:找不到要求的資源,但未來可能會再次提供。

500 Internal Server Error

處理這個要求時發生錯誤。 請稍後再試一次。

安全性

azure_auth

這些是 Azure Active Directory 的 OAuth2 流程。 與 Azure 角色型訪問 控制搭配使用時,可用來控制 Azure 地圖服務 REST api 的存取權。 Azure 角色型存取控制可用來指定對一或多個 Azure 地圖服務資源帳戶或子資源的存取權。 任何使用者、群組或服務主體都可以透過內建角色或由一個或多個許可權所組成的自訂角色來授與 Azure 地圖服務 REST Api 的存取權。

若要執行案例,我們建議您查看 驗證概念。 總而言之,此安全性定義提供的解決方案可讓您透過可對特定 Api 和範圍進行存取控制的物件來建立應用程式 () 的模型。

注意

  • 此安全性定義 需要 使用 x-ms-client-id 標頭,以指出應用程式要求存取的 Azure 地圖服務資源。 這可以從 Maps 管理 API取得。
  • Authorization URL適用于 Azure 公用雲端實例。 主權 cloud 具有唯一的授權 Url 和 Azure Active directory 設定。
  • Azure 角色型存取控制是透過 Azure 入口網站、Powershell、CLI、Azure Sdk 或 REST Api,從 azure 管理平面 進行設定。
  • 使用 Azure 地圖服務 WEB SDK 可讓您針對多個使用案例來設定應用程式的設定。
  • 目前支援 Azure Active Directory v1.0 權杖。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

subscription-key

這是在透過 Azure 管理平面透過 Azure 入口網站、Powershell、CLI、Azure Sdk 或 REST Api 建立 Azure 地圖服務資源 時所布建的共用金鑰。 使用此金鑰,任何應用程式都有權存取所有 REST Api。 換句話說,這些金鑰目前可以視為其所發出之帳戶的主要金鑰。 對於公開的應用程式,我們建議使用伺服器存取 Azure 地圖服務 REST Api (可安全地儲存此金鑰)的伺服器存取。

Type: apiKey
In: query

範例

PostDataForPoints

Sample Request

POST https://atlas.microsoft.com/elevation/point/json?subscription-key=[subscription-key]&api-version=1.0
[
  {
    "lon": -121.66853362143819,
    "lat": 46.846464798637129
  },
  {
    "lon": -121.68853362143818,
    "lat": 46.856464798637127
  }
]

Sample Response

{
  "data": [
    {
      "coordinate": {
        "latitude": 46.846464798637129,
        "longitude": -121.66853362143819
      },
      "elevationInMeter": 2314.4534201722422
    },
    {
      "coordinate": {
        "latitude": 46.856464798637127,
        "longitude": -121.68853362143818
      },
      "elevationInMeter": 2506.1430038793778
    }
  ]
}
{
  "error": {
    "code": "400 BadRequest",
    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
  }
}
{
  "error": {
    "code": "401 Unauthorized",
    "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
  }
}
{
  "error": {
    "code": "403 Forbidden",
    "message": "Permission, capacity, or authentication issues."
  }
}
{
  "error": {
    "code": "404 NotFound",
    "message": "Not Found: the requested resource could not be found, but it may be available again in the future."
  }
}
{
  "error": {
    "code": "500 InternalServerError",
    "message": "An error occurred while processing the request. Please try again later."
  }
}

定義

Coordinate

以緯度和經度表示的位置。

CoordinateAbbreviated

以緯度和經度表示的位置。

JsonFormat

所需的回應格式。 僅支援 json 格式。

ODataError

當 Maps API 中發生錯誤時,就會傳回此物件。

ODataErrorResponse

當 Maps API 中發生錯誤時,會傳回此回應物件。

PointElevationResult

提高許可權的資料。

PointsResult

來自成功的提高許可權點要求的回應。

Coordinate

以緯度和經度表示的位置。

Name Type Description
latitude
  • number

緯度屬性

longitude
  • number

經度屬性

CoordinateAbbreviated

以緯度和經度表示的位置。

Name Type Description
lat
  • number

緯度屬性

lon
  • number

經度屬性

JsonFormat

所需的回應格式。 僅支援 json 格式。

Name Type Description
json
  • string

JavaScript 物件標記法資料交換格式

ODataError

當 Maps API 中發生錯誤時,就會傳回此物件。

Name Type Description
code
  • string

ODataError 碼。

details

當 Maps API 中發生錯誤時,就會傳回此物件。

message
  • string

人類看得懂的錯誤描述 (若可取得)。

target
  • string

如果有的話,則會造成錯誤。

ODataErrorResponse

當 Maps API 中發生錯誤時,會傳回此回應物件。

Name Type Description
error

當 Maps API 中發生錯誤時,就會傳回此物件。

PointElevationResult

提高許可權的資料。

Name Type Description
coordinate

以緯度和經度表示的位置。

elevationInMeter
  • number

量值(以量值為單位)。

PointsResult

來自成功的提高許可權點要求的回應。

Name Type Description
data

點/點提高許可權 API 的回應。 結果會與要求中所列的點順序相同。