一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps Android API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps Android API
  3. 创建相应密钥
继续

控件和手势

您可以利用 Google Maps Android API,通过确定将哪些内置 UI 组件显示在地图上以及允许哪些手势,定制用户与地图进行交互的方式。

UI 控件

Maps API 提供的内置 UI 控件与您的 Android 手机上 Google 地图应用中提供的那些控件类似。 您可以利用 UiSettings 类切换这些控件的可见性,该类可通过 GoogleMap.getUiSettings 方法从 GoogleMap 获取。对该类所做的更改会立即体现在地图上。 如需查看这些功能的示例,请查看示例应用中的 UI Settings 演示版 Activity。

当地图是通过 XML 属性或使用 GoogleMapOptions 类创建时,您也可以配置其中的大部分选项。请参阅配置初始状态,了解更多详情。

每个 UI 控件都具有以地图边缘为参照物的预定位置。 您可以通过向 GoogleMap 对象添加内边距,加大控件与顶部、底部、左侧或右侧边缘的距离。

缩放比例控件

Maps API 提供的内置缩放比例控件出现在地图的右下角。 这些控件默认处于禁用状态,但可通过调用 UiSettings.setZoomControlsEnabled(true) 启用。

缩放比例控件

指南针

Maps API 提供的指南针图形会在特定情况下出现在地图的左上角。 仅当摄像头的朝向使得其具有非零方位或非零倾斜角度时,才会出现指南针。当用户点击指南针时,摄像头以动画呈现方式恢复到方位和倾斜角度为零的(默认朝向)位置,并且指南针会在之后不久逐渐消失。您可以通过调用 UiSettings.setCompassEnabled(boolean) 完全禁止指南针出现。不过,您无法强制始终显示指南针。

指南针

My Location 按钮

仅当启用了 My Location 层时,My Location 按钮才会出现在屏幕的右上角。 如需了解详情,请参阅有关位置数据的指南。

My Location 按钮

层级选取器

默认情况下,当用户查看室内地图时,层级选取器(楼层选取器)会出现在靠近屏幕中心右侧边缘位置。 如果有两个或更多个室内地图可见,层级选取器将应用于当前获得焦点的建筑,通常是最靠近屏幕中心的建筑。每栋建筑都具有首次显示选取器时默认选定的层级。用户可通过从选取器中进行选择来选择不同的层级。

您可以通过调用 GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean) 禁用或启用层级选取器控件。

如果您想用自己的层级选取器替换默认层级选取器,便可执行这项操作。

层级选取器

地图工具栏

默认情况下,当用户点按标记时,工具栏出现在地图右下角。 工具栏让用户可以快速访问 Google 地图移动应用。

您可以通过调用 UiSettings.setMapToolbarEnabled(boolean) 启用和禁用该工具栏。

lite-mode 地图中,无论用户执行什么操作,该工具栏都一直存在。 在完全交互地图中,该工具栏会在用户点按标记时滑入,在标记失去焦点时再次滑出。

该工具栏显示的图标可访问 Google 地图移动应用中的地图视图或路线请求。 当用户点按该工具栏上的图标时,API 会生成一个 Intent,以启动 Google 地图移动应用中的相应 Activity。

The toolbar at bottom right.

在以上屏幕截图中,工具栏出现在地图右下角。 视地图内容,其上将不出现任何 Intent 图标、出现一个 Intent 图标或同时出现两个 Intent 图标,前提是 Google 地图移动应用支持生成的 Intent。

地图手势

通过 Google Maps Android API 创建的地图支持与 Google 地图应用相同的手势。 不过,在某些情况下,您可能想禁用特定手势,以便保持地图状态。 也可以编程方式设置缩放、平移、倾斜和方位 - 请参阅摄像头和视图,了解更多详情。请注意,禁用手势对您是否能以编程方式更改摄像头位置并无影响。

与 UI 控件类似,您也可以通过 UiSettings 类启用/禁用手势,可通过调用 GoogleMap.getUiSettingsGoogleMap 获取该类。对该类所做的更改会立即体现在地图上。 如需查看这些手势的示例,请查看示例应用中的 UI Settings 演示版 Activity(请参阅此处,了解安装方法)。

当地图是通过 XML 属性或使用 GoogleMapOptions 类创建时,您也可以配置这些选项。 请参阅配置地图,了解更多详情。

缩放手势

地图可对各种能够改变摄像头缩放比例的手势作出响应:

  • 两次点按可使缩放比例增加 1(放大)
  • 双指点按可使缩放比例减少 1(缩小)
  • 双指捏合/外放
  • 通过两次点按实现单指缩放,第二次点按时按住,然后上划缩小,或下划放大

您可以通过调用 UiSettings.setZoomGesturesEnabled(boolean) 禁用缩放手势。 这对用户是否能使用缩放控件执行缩放操作并无影响。

滚动(平移)手势

用户可通过用手指拖动地图来四处滚动(平移)地图。 您可以通过调用 UiSettings.setScrollGesturesEnabled(boolean) 禁用滚动。

倾斜手势

用户可通过将两指置于地图上,然后同时下移或上移来相应增大或减小倾斜角度。 您可以通过调用 UiSettings.setTiltGesturesEnabled(boolean) 禁用倾斜手势。

旋转手势

用户可通过将两指置于地图上,然后执行旋转动作来旋转地图。 您可以通过调用 UiSettings.setRotateGesturesEnabled(boolean) 禁用旋转。

发送以下问题的反馈:

此网页
Google Maps Android API
Google Maps Android API
需要帮助?请访问我们的支持页面