Amazon Maps API概述 (v2.5)
使用Amazon Maps API，您可以创建具有高质量交互式地图的平板电脑应用，这些地图流畅地支持捏合、旋转、缩放、平移和其他常见手势。
- Amazon Maps API的常见用例
- Amazon Maps API特性
- 支持Maps API v2.5的Fire平板电脑
- 最低API级别
- 国际地图支持
- 下载Amazon Maps SDK (v2.5)
- 技术概述
- 后续步骤
Amazon Maps API的常见用例
您能用Amazon Maps API做什么？ 常见的用例可能包括，显示企业的位置列表，以及含有地址和电话号码详情的弹出窗口。例如，示例应用有一个显示连锁咖啡店的交互式地图。用户可以单击Coffee Shops（咖啡店）按钮，在地图上显示所有咖啡店的位置。他们可以单击每家咖啡店，查看其地址和电话号码等等。若需相关演示，请参阅示例应用演示。
其他用途可以是评论应用，显示不同类别的附近不同企业。例如，用户可能会选择查看附近的所有餐馆、超市、加油站、咖啡馆或其他地方。另一个用途可以是步道或徒步旅行地图，用户可以通过交互手势探索地形。
尽管手机应用在移动场景中更常见，但平板电脑在交互式信息亭和实体活动（如博物馆或会议）中更普遍。平板电脑应用还为用户提供了更多的屏幕空间，可以在地图上查看详情和其他兴趣点。更大的屏幕空间允许用户更多地用手来操作地图。
您的应用中有许多不同的Amazon Maps API可能用途。下面是一些示例：
- 博物馆应用，可以让孩子们看到灭绝动物的位置
- 探险公园应用，可以让您看到所有游乐设施和浴室的位置
- 购物中心应用，在地图上突出显示不同商店类别
- 县郡应用，显示该地区所有公共游泳池和公园
- 旅游应用，显示一个地区的历史景点和其他兴趣点
我们在不同的空间不断交互，需要地图来引导我们到达感兴趣区域。您可以使用Amazon Maps API提供这些体验。您的应用将与世界各地使用的数百万台 Fire 平板电脑设备兼容。
Amazon Maps API特性
以下列举了Amazon Maps API最重要功能：
- 使用流畅的缩放和平移功能，显示高质量矢量贴图
- 显示标准和卫星地图瓦片
- 使用Fragment
- 显示位置数据
- 处理用户与地图的交互
- 添加标记以显示地图上的特定位置
- 绘制多段线以连接两个或更多位置
- 绘制多边形以突出显示邻域或圈选区域
以下是嵌入平板电脑应用的示例地图。这是一种静态表示 - 该应用可以让您以流畅的方式捏合、缩放、旋转和使用其他手势。
支持Maps API v2.5的Fire平板电脑
Fire平板电脑对Maps API v2.5的支持取决于平板电脑的Fire OS版本。安装Fire OS 5或更高版本的平板电脑支持Amazon Maps API。支持自两个特定日期开始： Fire OS 7是7月28日，Fire OS 5是10月26日。运行Fire OS 6的平板电脑将于7月28日升级为Fire OS 7。下表显示了详情。
| Fire平板电脑 | Maps v2.5支持 | 构建型号 | Android版本和API级别 | 最新Fire OS版本 |
|---|---|---|---|---|
| Fire HD 10（2023，第13代） | 否 | KFTUWI |
Android 11，API级别30 | Fire OS 8 |
| Fire Max 11（2023，第13代） | 否 | KFSNWI |
Android 11，API级别30 | Fire OS 8 |
| Fire HD 8（2022，第12代） | 支持 | KFRAWI (2GB)、KFRAPWI (3GB) |
Android 11，API级别30 | Fire OS 8 |
| Fire 7（2022，第12代） | 支持 | KFQUWI |
Android 11，API级别30 | Fire OS 8 |
| Fire HD 10（2021，第11代） | 支持 | KFTRWI（3GB）、KFTRPWI（4GB） |
Android 9、API级别28 | Fire OS 7 |
| Fire HD 8（2020，第10代） | 支持 | KFONWI |
Android 9、API级别28 | Fire OS 7 |
| Fire HD 10（2019，第9代） | 支持 | KFMAWI |
Android 9、API级别28 | Fire OS 7 |
| Fire 7（2019，第9代） | 是 | KFMUWI |
Android 9、API级别28 | Fire OS 7 |
| Fire HD 8（2018，第8代） | 是 | KFKAWI |
Android 9、API级别28 | Fire OS 7 |
| Fire HD 10（2017，第7代） | 自2020年10月26日起支持 | KFSUWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HD 8（2017，第7代） | 自2020年10月26日起支持 | KFDOWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire 7（2017，第7代） | 自2020年10月26日起支持 | KFAUWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HD 8（2016，第6代） | 自2020年10月26日起支持 | KFGIWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HD 10（2015，第5代） | 自2020年10月26日起支持 | KFTBWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HD 8（2015，第5代） | 自2020年10月26日起支持 | KFMEWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire（2015，第5代） | 自2020年10月26日起支持 | KFFOWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HDX 8.9（2014，第4代） | 自2020年10月26日起支持 | KFSAWA (WAN), KFSAWI (Wi-Fi) |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HD 7（2014，第4代） | 自2020年10月26日起支持 | KFASWI |
Android 5.1、API级别22 | Fire OS 5 |
| Fire HD 6（2014，第4代） | 自2020年10月26日起支持 | KFARWI |
Android 5.1、API级别22 | Fire OS 5 |
| Kindle Fire HDX 7（2013，第3代） | 不支持 | KFTHWA (WAN) KFTHWI (Wi-Fi) |
Android 4.4.2、API级别19 | Fire OS 4 |
| Kindle Fire HDX 8.9（2013，第3代） | 不支持 | KFAPWA (WAN) KFAPWI (Wi-Fi) |
Android 4.4.2、API级别19 | Fire OS 4 |
| Kindle Fire HD 7（2013，第3代） | 不支持 | KFSOWI |
Android 4.4.2、API级别19 | Fire OS 4 |
| Kindle Fire（2012，第2代） | 不支持 | KFOT |
Android 4.0.3、API级别15 | Fire OS 3 |
| Kindle Fire HD 7（2012，第2代） | 不支持 | KFTT |
Android 4.0.3、API级别15 | Fire OS 3 |
| Kindle Fire HD 8.9（2012，第2代） | 不支持 | KFJWA (WAN) KFJWI (Wi-Fi) |
Android 4.0.3、API级别15 | Fire OS 3 |
| Kindle Fire（2011，第1代） | 不支持 | Kindle Fire |
Android 2.3.3、API级别10 | Fire OS 2 |
要记住的关键一点是，从10月26日开始，所有运行Fire OS 5+的Fire平板电脑都将支持Maps API v2.5。有关Fire平板电脑规格的更多信息，请参阅以下主题：
最低API级别
Amazon Maps支持的最低API级别为Fire OS 5或API级别21。任何使用早期API级别的Fire平板电脑（例如低于Fire OS 5）都无法支持Amazon Maps API。有关更多详细信息，请参阅Amazon Maps SDK v1.0和v2.0弃用通知。
在您项目的build.gradle文件中，将Android SDK的最低版本(android:minSdkVersion)设置为21。您还可以将目标SDK版本(android:targetSdkVerion)设置为27。请参阅以下主题，了解使用这些API级别的详情。
- Fire平板电脑的Fire OS 6（Fire OS 6基于API级别25）
- Fire平板电脑的Fire OS 7（Fire OS 7基于API级别28）
这些主题强调了要升级到Android API级别25和28，您可能需要在应用中进行的更改。
国际地图支持
销售Fire平板电脑的国家或地区支持Amazon Maps API v2.5，但中国、日本和印度除外。为了确保您的应用未在日本分发，当您提交应用时，请在Target Your App（确定您应用的支持目标）屏幕上相应地配置销售国家（地区）。
尽管Amazon Maps API在某些市场/国家/地区不可用，但地图功能仍适用于这些地理区域。
下载Amazon Maps SDK (v2.5)
您可在此处下载Amazon Maps SDK (v2.5)：
SDK文件包含一个Android存档文件(AAR)、Maven POM文件、参考文档和示例应用。您还可在SDK下载页面上下载该文件。
技术概述
要在活动中显示亚马逊地图，您可以使用MapFragment类或SupportMapFraction类。显示地图后，用户可以使用触摸手势对其进行平移、缩放、旋转和倾斜。
您可以为地图设置多个选项，例如地图类型、启用/禁用地图操纵手势（旋转、滚动和倾斜）以及控制用户界面元素（缩放按钮和指南针按钮）的显示。
要操作地图，可以从MapFragment或SupportMapFragments中检索AmazonMap对象。AmazonMap类是用于地图的主类。
使用AmazonMapOptions可以在XML布局或代码中设置初始地图设置。
移动地图相机
地图相机确定地图显示的世界区域。
- 相机目标是地图中心的经纬度位置。
- 相机缩放级别设置显示区域的比例。随着数字的增大，相机会向地面靠近，以更详细地显示较小的区域。
- 相机方位角设置地图的取向。方位角以度衡量，并且使用方式和指南针方位角相似。例如，将方位角设置为0会将地图定向为“北”位于顶部，而将方位角设置成270会将地图旋转到正西方位于顶部的位置。
- 相机倾斜度是相机相对于地面的角度。
AmazonMap的CameraPosition属性包含有关当前相机位置的信息。
要将相机移动到新位置，必须创建一个CameraUpdate对象，该对象指定新位置、缩放、方位角和/或倾斜度，并将其传递至AmazonMap.moveCamera()方法。
显示用户的位置
您可以使用AmazonMap.setMyLocationEnabled()打开我的位置层，自动添加用户的当前位置和“定位”按钮。
在地图上绘制对象
地图应用通常在地图上绘制对象，例如指示兴趣点或目的地的标记、代表路线的线和其他形状。
标记
您可以通过在MarkerOptions对象中定义标记位置和其他属性，然后调用AmazonMap.addMarker()，将标记添加到地图中。标记可以使用自定义图标和颜色。
线条和形状
您可以将线条和形状添加到地图中。与标记类似，可以使用Options对象设置形状的初始设置，然后调用add方法绘制形状。您可以添加：
- 线条，由一系列的点定义(
Polyline)。 - 圆，由中心和半径定义(
Circle)。 - 多边形，由通过线连接的一系列至少三个点定义(
Polygon)。
有关更多信息，请参阅以下内容：