顯示正確的著作權屬性
使用 Azure 地圖服務轉譯服務作為基底圖或圖層時,您必須在地圖上顯示適當的資料提供者著作權屬性。 此資訊應該會顯示在地圖右下角。
上方影像是轉譯服務中地圖的範例,其中顯示道路樣式。 其會顯示地圖右下角的著作權屬性。
上方影像是轉譯服務中地圖的範例,其中顯示衛星樣式。 請注意,系統列出另一個資料提供者。
取得地圖屬性 API
取得地圖屬性 API 可讓您要求地圖著作權屬性資訊,以便在應用程式內的地圖上顯示。
使用取得地圖屬性 API 的時機
地圖著作權屬性資訊必須顯示在地圖上使用轉譯 API 的任何應用程式中,包括 Web 和行動應用程式。
使用任何 Azure 地圖服務 SDK (包括 Web、Android 和 iOS 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.road 、microsoft.base.hybrid 和 microsoft.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
其他資訊
- 如需詳細資訊,請參閱轉譯服務文件。