顯示正確的著作權屬性

使用 Azure 地圖服務轉譯服務作為基底圖或圖層時,您必須在地圖上顯示適當的資料提供者著作權屬性。 此資訊應該會顯示在地圖右下角。

The above image is an example of a map from the Render service showing the copyright attribution when using the road style

上方影像是轉譯服務中地圖的範例,其中顯示道路樣式。 其會顯示地圖右下角的著作權屬性。

The above image is an example of a map from the Render service showing the copyright attribution when using the satellite style

上方影像是轉譯服務中地圖的範例,其中顯示衛星樣式。 請注意,系統列出另一個資料提供者。

取得地圖屬性 API

取得地圖屬性 API 可讓您要求地圖著作權屬性資訊,以便在應用程式內的地圖上顯示。

使用取得地圖屬性 API 的時機

地圖著作權屬性資訊必須顯示在地圖上使用轉譯 API 的任何應用程式中,包括 Web 和行動應用程式。

使用任何 Azure 地圖服務 SDK (包括 WebAndroidiOS SDK) 時,會自動在地圖上顯示和更新屬性。

在協力廠商地圖中使用轉譯服務的地圖底圖時,您必須在地圖上顯示及更新著作權屬性資訊。

每當使用者選取不同的樣式、放大或縮小或移動瀏覽地圖時,地圖內容就會變更。 這些所有的使用者動作都會觸發事件。 當其中任何一個事件觸發時,您必須呼叫取得地圖屬性 API。 一旦您擁有更新的著作權屬性資訊之後,您必須在地圖的右下角予以顯示。

由於資料提供者可能會根據區域和縮放比例而有所不同,因此取得地圖屬性 API 會採用這些參數作為輸入,並傳回對應的屬性文字。

如何使用取得地圖屬性 API

您需要下列資訊,才能執行 attribution 命令:

參數 類型 描述
api-version string Azure 地圖服務 API 的版本號碼。
邊界 陣列 字串,表示周框方塊的矩形區域。 邊界參數是由四個周框方塊的座標所定義。 前 2 個是定義西南部角落的 WGS84 經度和緯度,最後 2 個是定義東北角落的 WGS84 經度和緯度。 字串的格式如下:[SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude]。
tilesetId TilesetID 地圖底圖集是點陣或向量資料的集合,分為預設縮放層級的方形地圖底圖統一方格。 每個地圖底圖集都有一個 tilesetId,在提出要求時使用。 使用 Azure 地圖服務建立者所建立地圖底圖集的 tilesetId 是透過 Tileset Create API 產生。 Azure 地圖服務提供現成可用的地圖底圖集,例如 microsoft.base.roadmicrosoft.base.hybridmicrosoft.weather.radar.main取得地圖屬性 REST API 文件中可以找到完整的清單。
縮放 整數 所地圖底圖的縮放層級。 有效範圍取決於地圖底圖,如需特定地圖底圖集的有效值,請參閱 TilesetID 資料表。 如需詳細資訊,請參閱縮放層級和圖格格線一文。
subscription-key string Azure 地圖帳戶提供的其中一個 Azure 地圖服務金鑰。 如需詳細資訊,請參閱驗證 Azure 地圖服務一文。

執行下列 GET 要求,以取得地圖上顯示的對應著作權屬性:

https://atlas.microsoft.com/map/attribution?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2.1&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.579490,-122.247157,47.668372

其他資訊