你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

显示正确的版权归属

使用 Azure Maps 呈现服务时,无论是将其用作基础地图还是用作层,都需要在地图上显示相应的数据提供程序版权归属。 此信息应显示在地图右下角。

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 Maps SDK(包括 WebAndroidiOS SDK)时,将会自动在地图上显示和更新归属。

使用第三方地图中呈现服务的地图磁贴时,必须显示并更新地图上的版权归属信息。

当最终用户选择不同的样式、进行放大或缩小或平移地图时,地图内容会更改。 这其中的每个用户操作都会触发某个事件。 触发这其中的任何事件时,需要调用获取地图归属 API。 获得更新的版权归属信息后,需要将其显示在地图的右下角。

由于数据提供程序可能因区域和缩放级别而异,因此获取地图归属 API 会将这些参数用作输入,并返回相应的特性文本。

如何使用获取地图归属 API

要运行 attribution 命令,需要以下信息:

参数 类型 说明
api-version 字符串 Azure Maps API 的版本号。
bounds array 一个字符串,表示边界框的矩形区域。 bounds 参数由四个边界框坐标定义。 前 2 个是定义西南角的 WGS84 经度和纬度,后 2 个是定义西北角的 WGS84 经度和纬度。 该字符串采用以下格式:[SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude]。
tilesetId TilesetID 图块集是在预设缩放级别分解为方形图块的统一网格的光栅或矢量数据的集合。 发出请求时,每个图块集都有一个要使用的 tilesetId。 使用 Azure Maps Creator 创建的图块集的 tilesetId 是通过图块集创建 API 生成的。 Azure Maps 提供了随时可用的图块集,例如 microsoft.base.roadmicrosoft.base.hybridmicrosoft.weather.radar.main,你可以在获取地图归属 REST API 文档中找到完整列表。
缩放 integer 所选磁贴的缩放级别。 有效范围取决于磁贴。请参阅 TilesetID 表,了解特定图块集的有效值。 有关详细信息,请参阅缩放级别和磁贴网格一文。
subscription-key string 从 Azure Maps 帐户提供的 Azure Maps 密钥之一。 有关详细信息,请参阅向 Azure Maps 进行身份验证一文。

运行以下 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

其他信息