你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
使用 Azure Maps 呈现服务(作为底图或图层)时,需要在地图上显示相应的数据提供程序版权归属。 此信息应显示在地图右下角。
上图是呈现服务中的地图示例,显示道路样式。 它显示地图右下角的版权归属。
上图是渲染服务的地图示例,采用了卫星样式。 请注意,列出了另一个数据提供程序。
获取地图归属 API
使用“获取地图归因 API”可以请求地图版权归属信息,以便在应用程序中在地图上显示。
何时使用“获取地图归因 API”
地图版权归属信息必须在使用呈现 API 的任何应用程序中在地图上显示。
在第三方地图中使用呈现服务中的地图磁贴时,必须在地图上显示和更新版权归属信息。
每当最终用户选择其他样式、放大或缩小或平移地图时,地图内容都发生变化。 其中的每个用户操作都会触发某个事件。 当其中任何一个事件触发时,需要调用“获取地图归因 API”。 获得更新的版权归属信息后,需要将其显示在地图的右下角。
由于数据提供程序可能因 区域 和 缩放 级别而异,因此获取地图属性 API 将这些参数作为输入并返回相应的属性文本。
如何使用“获取地图归因 API”
需要以下信息才能运行 attribution
命令:
参数 | 类型 | DESCRIPTION |
---|---|---|
api-version | 字符串 | Azure Maps API 的版本号。 |
bounds | 数组 | 一个字符串,表示边界框的矩形区域。 边界参数由四个边界框坐标定义。 前 2 个是定义西南角的 WGS84 经度和纬度,最后 2 个是定义东北角的 WGS84 经度和纬度。 字符串采用以下格式显示:[SouthwestCorner_Longitude、SouthwestCorner_Latitude、NortheastCorner_Longitude、NortheastCorner_Latitude]。 |
tilesetId | TilesetID | 图块集是一组光栅或矢量数据,按照预设的缩放级别被划分为统一的方形图块网格。 每个图块集都有一个 tilesetId,用于发出请求。 使用 Azure Maps Creator 创建的图块集的 tilesetId 是通过 Tileset Create API 生成的。 Azure Maps 提供了随时可用的图块集,例如 microsoft.base.road 、microsoft.base.hybrid 和 microsoft.weather.radar.main ,可以在获取地图归属 REST API 文档中查找完整列表。 |
zoom | 整数 | 所选图块的缩放级别。 有效范围取决于磁贴,请参阅 TilesetID 表以获取特定图块集的有效值。 有关详细信息,请参阅 缩放级别和磁贴网格 文章。 |
订阅密钥 | 字符串 | Azure Maps 帐户提供的 Azure Maps 密钥之一。 有关详细信息,请参阅 Azure Maps 身份验证 文章。 |
运行以下 GET 请求以获取在地图上显示的相应版权归属:
https://atlas.microsoft.com/map/attribution?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.579490,-122.247157,47.668372
其他信息
- 有关详细信息,请参阅呈现服务文档。