导航|地址|刷新
概述-Android 地图SDK | 高德地图API













控制台

去认证企业


登录注册









退出


我的消息

云图市场

应用管理

GeoHUB




产品介绍

产品介绍高德开放平台产品介绍 查看全部文档

搜索定位


鸿蒙星河版定位SDK HOT鸿蒙星河版定位SDK

搜索 HOT位置、周边、行政区、ID等查询接口 API JS Android iOS

定位 HOT基于LBS的定位服务 API Android iOS

地理/逆地理编码 位置名称与经纬度之间转换服务 API JS Android iOS

地理围栏 虚拟空间围栏服务 API Android iOS

天气查询 查询目标区域当前/未来天气

智能硬件定位 通过基站、Wifi获取位置信息




路线导航


鸿蒙星河版导航SDK NEW鸿蒙星河版导航SDK

导航 HOT轻松地在APP中加入导航能力 Android iOS

路线规划 HOT提供步行、驾车等规划能力 API JS Android iOS

猎鹰服务 提供专业轨迹管理服务 API Android iOS

货车路径规划 专业的货车路径规划服务 API Android iOS

智能调度引擎 智能外勤调度，提升效益

物流服务 提供智慧物流API服务接口

公交信息查询 查询公交信息

交通路况查询 查询交通态势情况

高级路径规划 高级路径规划等能力




地图产品


鸿蒙星河版地图SDK HOT鸿蒙星河版-轻量地图SDK

动态地图 HOT动态地图展示、配置 API JS Android iOS HarmonyOS

3D地图 HOT3D动态地图展示、配置

地铁图 简单易用的移动端地铁线路图开发接口 JS Android iOS

静态地图 灵活地将高德地图迁入应用网页

3D地形图 卫星地形图还原真实地形地貌




高级地图工具


世界地图 NEW

自定义地图

地图数据可视化 (LOCA)

地图数据中心 (GeoHUB)

坐标拾取器

高德地图URI Web

高德地图URI APP

三维模型转换

微信小程序插件

地图Flutter插件

地图名片




高德地图小程序


地图小程序

客户管理

员工管理

送货提效

地图小程序API




空间智能开放平台


空间智能开放平台 NEW用真实空间信息解答业务问题






解决方案

解决方案提供各行业LBS解决方案


空间智能 NEW提供LBS领域的Agent解决方案

智能手表 NEW提供智能守护与运动出行解决方案

智能眼镜 NEW智能眼镜实时导航及智慧出行解决方案

世界地图 NEW面向开发者提供全球范围内LBS服务

智能两轮车 NEW合规精确的两轮车场景导航

手机银行 NEW提供手机银行APP地图应用





网格化营销 NEW提供银行网格化营销场景应用

智慧交通 优化交通资源配置，赋能智慧交通系统

出行 提供网约车等出行场景解决方案

O2O 到店、到家等多种O2O业务解决方案

上门服务调度 提供上门业务调度解决方案





三农场景可视化 NEW提供乡村振兴三农场景应用

社交 社交应用位置服务解决方案

运动 运动类应用解决方案

智能硬件 智能硬件LBS解决方案

零售铺货 零售快消行业，渠道铺货解决方案





智慧物流 针对物流行业提供解决方案

电商 电商物流行业解决方案

地址服务 综合地址服务，满足客户全景化需求

企业智图 一张图轻松管理企业数据

智能派单 一站式精准智能派单解决方案






文档与支持

文档与支持高德开放平台开发文档与服务支持 查看全部文档

API


Web基础服务API

Web高级服务API

物流服务API

猎鹰服务 API




JS API


JS API

数据可视化JS API

地图组件

URI API

地铁图 JS API




Android 平台


Android 地图SDK

Android 轻量版地图SDK

Android 定位SDK

Android 导航SDK

Android 猎鹰SDK




iOS 平台


iOS 地图SDK

iOS 轻量版地图SDK

iOS 定位SDK

iOS 导航SDK

iOS 猎鹰SDK




鸿蒙星河版平台


鸿蒙星河版地图SDK HOT

鸿蒙星河版定位SDK HOT

鸿蒙星河版导航SDK NEW




大模型开发工具


SKILL专区 NEW

MCP Server NEW

高德开放平台 CLI NEW




服务与支持


常见问题

创建工单

示例中心

合规中心

技术服务许可查询






定价

定价开放平台产品定价 产品定价

产品定价


产品定价

技术服务许可

GeoHUB自定义地图

GeoHUB数据中心




产品升级


高级能力

企业智图SaaS

云图市场






为什么选择高德




















历史记录

热门推荐
Android定位Android定位问题相关

浏览器定位JS API提供Geolocation定位插件

逆地理编码经纬度转换为详细结构化的地址

自定义地图7大类44种地图元素可定制

认证开发商商业授权相关问题














Android 地图SDK


概述

入门指南

开发指南
创建工程
获取Key

Eclipse 配置工程

Android Studio 配置工程

Android Wear 开发

开发注意事项


创建地图
显示地图

显示定位蓝点

显示3D地形图

显示室内地图

切换地图图层

使用离线地图

自定义地图

世界地图


与地图交互
控件交互

手势交互

调用方法交互

地图截屏功能


在地图上绘制
绘制点标记

绘制线

绘制面

绘制热力图

绘制3D模型

轨迹纠偏

点平滑移动

绘制海量点图层


获取地图数据
获取POI数据

获取地址描述数据

获取公交数据

获取行政区划数据

获取天气数据


出行路线规划
驾车出行路线规划

步行出行路线规划

公交出行路线规划

骑行出行路线规划

货车出行路线规划

未来行程路线规划




地图计算工具
坐标转换

距离/面积计算

距离测量


实用工具
天气对照表

错误码对照表

Android 6.0权限说明



参考手册

示例代码

示例中心

常见问题

更新日志
3D 地图 SDK

搜索功能


相关下载






开发Android 地图SDK概述


概述最后更新时间: 2025年12月03日


重要：由于个人信息保护法的实施，从地图8.1.0版本起对旧版本SDK不兼容，请务必确保调用SDK任何接口前先调用更新隐私合规updatePrivacyShow、updatePrivacyAgree两个接口，具体可参考开发指南-其他配置注意事项-隐私合规接口说明传入相关参数。否则可能产生的异常情况如下：

MapView、TextureMapView、MapFragment显示白屏；

OfflineMapManager、OfflineMapActivity、LBSTraceClient、搜索接口也需在初始化时对抛出的异常进行捕获，否则可能导致编译不通过、空指针等异常情况；

Flutter兼容性：Flutter3.0.0版本已发布，兼容Android定位5.6.0、iOS定位2.8.0、地图8.1.0及以上版本，可前往 Flutter插件下载页面 获取对应版本

Android地图SDK简介

高德开放平台目前开放了Android 地图 SDK 以及 Android 地图 SDK 专业版两套地图SDK工具。

高德地图 Android SDK 是一套地图开发调用接口，开发者可以轻松地在自己的Android应用中加入地图相关的功能，包括：地图显示（含室内、室外地图）、与地图交互、在地图上绘制、兴趣点搜索、地理编码、离线地图等功能。

高德地图 Android SDK 专业版是在 Android SDK 已有服务的基础上，新增支持了自定义地图在线加载、自定义地图元素纹理等功能，便于开发者完成基于自身场景的更深层、更个性化地图的开发需求。

V4.0.0开始，除了支持手机设备外，还支持Android Wear。

功能介绍与体验




抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签



抱歉，您的浏览器不支持video标签




展示地图
package com.amap.map3d.demo.basic; import android.app.Activity; import android.os.Bundle; import com.amap.api.maps.AMap; import com.amap.api.maps.MapView; import com.amap.map3d.demo.R; public class AmapActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.basicmap_activity); MapView mapView = (MapView) findViewById(R.id.map); mapView.onCreate(savedInstanceState);// 此方法必须重写 AMap aMap = mapView.getMap(); aMap.setTrafficEnabled(true);// 显示实时交通状况 //地图模式可选类型：MAP_TYPE_NORMAL,MAP_TYPE_SATELLITE,MAP_TYPE_NIGHT aMap.setMapType(AMap.MAP_TYPE_SATELLITE);// 卫星地图模式 } }


覆盖物
public class AmapActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.basicmap_activity); MapView mapView = (MapView) findViewById(R.id.map); mapView.onCreate(savedInstanceState);// 此方法必须重写 AMap aMap = mapView.getMap(); //绘制marker Marker marker = aMap.addMarker(new MarkerOptions() .position(new LatLng(39.986919,116.353369)) .icon(BitmapDescriptorFactory.fromBitmap(BitmapFactory .decodeResource(getResources(),R.drawable.marker))) .draggable(true)); // 绘制曲线 aMap.addPolyline((new PolylineOptions()) .add(new LatLng(43.828, 87.621), new LatLng(45.808, 126.55)) .geodesic(true).color(Color.RED)); } }


路径规划
/** * 开始搜索路径规划方案 */ public void searchRouteResult(int routeType, int mode) { if (mStartPoint == null) { ToastUtil.show(mContext, "起点未设置"); return; } if (mEndPoint == null) { ToastUtil.show(mContext, "终点未设置"); } showProgressDialog(); final RouteSearch.FromAndTo fromAndTo = new RouteSearch.FromAndTo( mStartPoint, mEndPoint); if (routeType == ROUTE_TYPE_BUS) {// 公交路径规划 BusRouteQuery query = new BusRouteQuery(fromAndTo, mode, mCurrentCityName, 0);// 第一个参数表示路径规划的起点和终点，第二个参数表示公交查询模式，第三个参数表示公交查询城市区号，第四个参数表示是否计算夜班车，0表示不计算 mRouteSearch.calculateBusRouteAsyn(query);// 异步路径规划公交模式查询 } else if (routeType == ROUTE_TYPE_DRIVE) {// 驾车路径规划 DriveRouteQuery query = new DriveRouteQuery(fromAndTo, mode, null, null, "");// 第一个参数表示路径规划的起点和终点，第二个参数表示驾车模式，第三个参数表示途经点，第四个参数表示避让区域，第五个参数表示避让道路 mRouteSearch.calculateDriveRouteAsyn(query);// 异步路径规划驾车模式查询 } else if (routeType == ROUTE_TYPE_WALK) {// 步行路径规划 WalkRouteQuery query = new WalkRouteQuery(fromAndTo, mode); mRouteSearch.calculateWalkRouteAsyn(query);// 异步路径规划步行模式查询 } }


POI搜索
/** * 开始进行poi搜索 */ protected void doSearchQuery() { keyWord = mSearchText.getText().toString().trim(); currentPage = 0; query = new PoiSearch.Query(keyWord, "", "北京市"); query.setPageSize(20);// 设置每页最多返回多少条poiitem query.setPageNum(currentPage);// 设置查第一页 if (lp != null) { poiSearch = new PoiSearch(this, query); poiSearch.setOnPoiSearchListener(this); poiSearch.setBound(new SearchBound(lp, 5000, true));// poiSearch.searchPOIAsyn();// 异步搜索 } }


自定义OpenGL渲染
... /** * 初始化AMap对象 */ private void init() { if (aMap == null) { aMap = mapView.getMap(); //关闭文字 aMap.showMapText(false); //关闭3d楼块 aMap.showBuildings(false); //注1：设置opengl Renderer aMap.setCustomRenderer(new MapRenderer(aMap)); } } ... class MapRenderer implements CustomRenderer{ //平移位置 private float[] translate_vector = new float[4]; //缩放比例 public static float SCALE = 0.005F; private LatLng center = new LatLng(39.90403, 116.407525);// 北京市经纬度 private AMap aMap; public MapRenderer(AMap aMap) { this.aMap = aMap; aMap.moveCamera(CameraUpdateFactory.newLatLngZoom(center,15)); } @Override public void onDrawFrame(GL10 gl) { // 注2：绘制各种图形的opengl代码 } ... @Override public void OnMapReferencechanged() { //注3：回调这个时，坐标系发生改变，需要重新计算缩放比例 calScaleAndTranslate(); } private void calScaleAndTranslate() { // 坐标会变化，重新计算计算偏移，供参考，可以自行定义 PointF pointF = aMap.getProjection().toOpenGLLocation(center); translate_vector[0] = pointF.x; translate_vector[1] = pointF.y; translate_vector[2] = 0; //重新计算缩放比例 LatLng latLng2 = new LatLng(center.latitude + 0.001, center.longitude + 0.001); PointF pointF2 = aMap.getProjection().toOpenGLLocation(latLng2); double _x = Math.abs((pointF.x - pointF2.x)); double _y = Math.abs((pointF.y - pointF2.y)); SCALE = (float) Math.sqrt((_x * _x + _y * _y)); } }


离线地图
// 设置应用单独的地图存储目录，在下载离线地图或初始化地图时设置 MapsInitializer.sdcardDir = getSdCacheDir(this); private String getSdCacheDir(Context context) { return "地址路径"; } //按照citycode下载 OfflineMapManager.downloadByCityCode(String citycode); //按照cityname下载 OfflineMapManager.downloadByCityName(String cityname); /** * 点击暂停按钮响应事件回调 */ amapManager = new OfflineMapManager(context, OfflineMapDownloadListener ); amapManager.pause();




下载完整示例代码



账号与Key的申请

注册成为高德开发者需要分三步：

第一步，注册高德开发者；

第二步，去控制台创建应用；

第三步，获取Key。

具体步骤可参看下图



获取 API Key



开发者使用注意事项

法人或非法人组织使用平台服务应事先购买技术服务许可以获取许可。若您未购买技术服务许可，平台向您提供的KEY和服务配额仅供您用于短期、少量的测试目的；若您超出前述范围使用平台服务（包括但不限于您开始向第三方或公众销售或提供您的应用、将您的应用用于参与第三方投标、您的应用在应用程序分发平台上架或已经可以被公众获取使用、您的应用开始收费或发布广告或以其他方式获益、在组织内部使用的您的应用已上线运营、您的应用长期或大量调用平台服务等情形），构成未许可使用，平台有权采取相应措施。关于具体使用规则，请参阅《高德地图开放平台服务协议》获得详细信息。 













本页目录

Android地图SDK简介

功能介绍与体验

开发者使用注意事项








新手入门产品与服务解决方案开发文档

商务合作商务合作商家合作

常见问题账号问题定位反馈常见问题汇总服务协议隐私权政策免责声明数据退出

开放平台关注我们微信微博


阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 飞猪 | 阿里云计算 | AliOS | 阿里通信 | 一淘 | 万网 | 高德 | UC | 友盟 | 虾米 | 阿里星球 | 点点虫 | 钉钉 | 支付宝 | 优酷 | 土豆 | 阿里健康 | 阿里影业 | 阿里体育 | 网商银行 | 高德打车企业版 | 高德地图汽车业务中心 | 高德智慧景区
© 2002-2026 Amap.com 版权所有 | 京ICP备2023020281号-12 | 甲测资字11112528 | 甲测资字11111093

京公网安备 11010502056787号



返回顶部示例中心常见问题智能客服公众号
二维码


------
导航页 打开网址