你当前正在访问 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.roadmicrosoft.base.hybridmicrosoft.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

其他信息