本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 地图 API
<a name="choose-maps-apis"></a>

地图 API 提供对动态和静态地图类型的访问权限，适用于各种应用程序。有关更多信息，请参阅[Amazon Location Service 地图](maps.md)。
+ **动态地图**：可实时自定义的交互式地图，支持用户平移、缩放和叠加数据。有关更多信息，请参阅[动态地图](dynamic-maps.md)。
+ **静态地图**：显示特定位置或路线的地图的静态图像（不含交互式元素），适用于交互性有限的应用程序。有关更多信息，请参阅[静态地图](static-maps.md)。

下表列出了一些适合使用地图 API 解决的业务使用案例。

## 地图使用案例
<a name="maps-table"></a>

以下部分展示了一些适合使用地图 API 解决的业务使用案例。


| **业务需求** | **有用的 API** | **示例** | 
| --- | --- | --- | 
| **显示交互式地图**<br />支持地图操作手势，例如缩放、平移、缓动、飞行、俯仰、旋转和方位调整。 | `GetTile` 和 `GetStyleDescriptor`，使用渲染引擎（MapLibre） | [如何显示地图](how-to-display-a-map.md) | 
| **向地图添加标记**<br />例如标记、图标等。 | `GetTile` 和 `GetStyleDescriptor`，使用渲染引擎（MapLibre） | [如何在地图上添加标记](how-to-add-marker-on-map.md)<br />[如何在地图上添加图标](how-to-add-icon-on-map.md) | 
| **向地图添加用户交互组件**<br />例如，以首选语言或地缘政治观点显示地图。 | `GetTile` 和 `GetStyleDescriptor`，使用渲染引擎（MapLibre） | [如何在地图上添加控件](how-to-add-control-on-map.md)<br />[如何向地图添加弹出窗口](how-to-add-popup-to-map.md) | 
| **在地图上呈现实时数据或预先录制的数据**<br />例如，热图、KML、GeoJSON 特征、多边形、矩形、折线、圆圈、标记等。 | `GetTile` 和 `GetStyleDescriptor`，使用渲染引擎（MapLibre） | [如何在地图上添加线条](how-to-add-line-on-map.md)<br />[如何在地图上添加多边形](how-to-add-polygon-on-map.md) | 
| **显示带有本地化功能的地图**例如，以首选语言或地缘政治观点显示地图。 | `GetTile` 和 `GetStyleDescriptor`，使用渲染引擎（MapLibre） | [如何为地图设置首选语言](how-to-set-preferred-language-map.md)<br />[如何设置地图的政治观点](how-to-set-political-view-map.md) | 
| **显示静态地图图像**<br />例如，在应用程序、电子邮件、报告或打印中使用地图图像。 | `GetStaticMap` | [如何获取特定位置的静态地图](get-static-map-specific-position.md)<br />[如何获取特定尺寸的静态地图](get-static-map-specific-dimension.md)<br />[生成静态地图时如何在 radius 和 zoom 之间做出选择](choose-radius-vs-zoom.md)<br />[如何为静态地图添加比例尺](add-scale-static-map.md) | 
| **向地图图像添加标记**<br />例如标记、邻近圆圈、图标等。 | `GetStaticMap` | [如何向静态地图添加标记](add-marker-static-map.md) | 
| **在地图图像上呈现数据**<br />例如 GeoJSON 特征、多边形、矩形、折线、圆圈等。 | `GetStaticMap` | [如何向静态地图添加线条](how-to-add-line-static.md) | 
| **在地图上呈现实际使用案例**<br />示例包括路线、邻近圆圈等。 | `GetStaticMap` | [如何向静态地图添加路线](how-to-add-route.md) | 
| **在地图上呈现地点搜索和/或地理编码结果**除自动补全功能外，所有 API 都返回地理坐标。 | GetTile 和 GetStyleDescriptor，使用带 Places API 的渲染引擎（MapLibre） |  | 
| **在地图上绘制路线**支持航点标记。 | GetTile 和 GetStyleDescriptor，使用带“计算路线”功能的渲染引擎（MapLibre）  |  | 
| **在地图上呈现匹配的 GPS 轨迹**支持卡车、行人、汽车和踏板车等出行模式。 | GetStyleDescriptor，使用带“与道路对齐”功能的渲染引擎（MapLibre）  |  |