导航|地址|刷新
获取地址描述数据-获取地图数据-开发指南-iOS 地图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种地图元素可定制

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














iOS 地图SDK


概述

入门指南

开发指南
创建工程
获取Key

自动部署

手动部署

开发者注意事项

基础SDK介绍

提交AppStore必读

应用HTTPS解决方案


创建地图
显示地图

显示定位蓝点

显示3D地形图

显示室内地图

切换地图图层

使用离线地图

自定义地图

世界地图


与地图交互
控件交互

手势交互

调用方法交互

地图截屏功能


获取地图数据
获取POI数据

获取地址描述数据

获取公交数据

获取行政区划数据

获取天气数据

获取交通态势信息


在地图上绘制
绘制点标记

绘制折线

绘制面

轨迹纠偏

点平滑移动

绘制海量点图层


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

步行出行路线规划

公交出行路线规划

骑行出行路线规划

货车出行路线规划

未来行程路线规划




地图计算工具
坐标转换

距离/面积计算

距离测量


实用工具
错误码表

天气对照表

基于 Swift 的地图应用开发

体积说明



参考手册
3D 地图 SDK

2D 地图 SDK

搜索功能

Foundation(基础) SDK


示例代码

示例中心

常见问题

更新日志
3D 地图 SDK

搜索功能

Foundation(基础) SDK


相关下载






开发iOS 地图SDK开发指南获取地图数据获取地址描述数据


获取地址描述数据最后更新时间: 2021年01月22日


注意：下面介绍的功能使用的是地图SDK的搜索功能，需要在工程中导入搜索功能库(AMapSearchKit.framework)。

地理编码（地址转坐标）

地理编码基本介绍

地理编码，又称为地址匹配，是从已知的地址描述到对应的经纬度坐标的转换过程。该功能适用于根据用户输入的地址确认用户具体位置的场景，常用于配送人员根据用户输入的具体地址找地点。

地址的定义： 首先，地址肯定是一串字符，内含国家、省份、城市、城镇、乡村、街道、门牌号码、屋邨、大厦等建筑物名称。按照由大区域名称到小区域名称组合在一起的字符。一个有效的地址应该是独一无二的。注意：针对大陆、港、澳地区的地理编码转换时可以将国家信息选择性的忽略，但省、市、城镇等级别的地址构成是不能忽略的。

注意：不要将该功能与POI关键字搜索混用。

POI关键字搜索，是根据关键词找到现实中存在的地物点（POI）。

地理编码是依据当前输入，根据标准化的地址结构（省/市/区或县/乡/村或社区/商圈/街道/门牌号/POI）进行各个地址级别的匹配，以确认输入地址对应的地理坐标，只有返回的地理坐标匹配的级别为POI，才会对应一个具体的地物（POI）。

使用地理编码

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。



Objective-CSwift


#import <AMapFoundationKit/AMapFoundationKit.h> #import <AMapSearchKit/AMapSearchKit.h>

//在桥接文件中引入头文件 #import <AMapFoundationKit/AMapFoundationKit.h> #import <AMapSearchKit/AMapSearchKit.h>




第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK AMapFoundationKit.framework ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：



Objective-CSwift


[AMapServices sharedServices].apiKey = @"您的key";

AMapServices.shared().apiKey = "您的Key"




如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：



Objective-CSwift


[AMapSearchServices sharedServices].apiKey = @"您的key";

AMapSearchServices.shared().apiKey = "您的Key"




第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。



Objective-CSwift


self.search = [[AMapSearchAPI alloc] init]; self.search.delegate = self;

search = AMapSearchAPI() search.delegate = self




第 5 步，设置地理编码查询参数

地理编码，请求参数类为 AMapGeocodeSearchRequest，address是必设参数。



Objective-CSwift


AMapGeocodeSearchRequest *geo = [[AMapGeocodeSearchRequest alloc] init]; geo.address = @"北京市朝阳区阜荣街10号";

let request = AMapGeocodeSearchRequest() request.address = "北京市朝阳区阜荣街10号"




第 6 步，发起地理编码查询

调用 AMapSearchAPI 的 AMapGeocodeSearch 并发起地理编码。



Objective-CSwift


[self.search AMapGeocodeSearch:geo];

search.aMapGeocodeSearch(request)




第 7 步，在回调中处理数据

当地理编码查询成功时，会进到 onGeocodeSearchDone 回调函数中，通过解析 AMapGeocodeSearchResponse 把检索结果在地图上绘制点展示出来。

说明：

1）可以在回调中解析 response，获取地址对应的地理信息。

2）通过 response.geocodes 可以获取到 AMapGeocode 列表，POI 详细信息可参考 AMapGeocode 类。



Objective-CSwift


- (void)onGeocodeSearchDone:(AMapGeocodeSearchRequest *)request response:(AMapGeocodeSearchResponse *)response { if (response.geocodes.count == 0) { return; } //解析response获取地理信息，具体解析见 Demo }

func onGeocodeSearchDone(_ request: AMapGeocodeSearchRequest!, response: AMapGeocodeSearchResponse!) { if response.geocodes == nil { return } //解析response获取地理信息，具体解析见 Demo }




逆地理编码（坐标转地址）

逆地理编码基本介绍

逆地理编码，又称地址解析服务，是指从已知的经纬度坐标到对应的地址描述（如行政区划、街区、楼层、房间等）的转换。常用于根据定位的坐标来获取该地点的位置详细信息，与定位功能是黄金搭档。

使用逆地理编码

第 1 步，引入头文件

引入 AMapFoundationKit.h 和 AMapSearchKit.h 这两个头文件。



Objective-CSwift


#import <AMapFoundationKit/AMapFoundationKit.h> #import <AMapSearchKit/AMapSearchKit.h>

//在桥接文件中引入头文件 #import <AMapFoundationKit/AMapFoundationKit.h> #import <AMapSearchKit/AMapSearchKit.h>




第 2 步，配置Key

在使用搜索功能时，需要添加 Key。

如果您使用的是搜索库（AMapSearchKit.framework） v4.x 版本需要引入基础 SDK AMapFoundationKit.framework ，设置 Key 的方法如下：

iOS 搜索功能 v4.x 版本设置 Key：



Objective-CSwift


[AMapServices sharedServices].apiKey = @"您的key";

AMapServices.shared().apiKey = "您的Key"




如果您使用的是搜索功能 v3.x 或之前版本，请您尽快更新。

iOS 搜索功能 v3.x 版本设置 Key：



Objective-CSwift


[AMapSearchServices sharedServices].apiKey = @"您的key";

AMapSearchServices.shared().apiKey = "您的Key"




第 3 步，定义 AMapSearchAPI

定义主搜索对象 AMapSearchAPI ，并继承搜索协议<AMapSearchDelegate>。

第 4 步，构造 AMapSearchAPI

构造主搜索对象 AMapSearchAPI，并设置代理。



Objective-CSwift


self.search = [[AMapSearchAPI alloc] init]; self.search.delegate = self;

search = AMapSearchAPI() search.delegate = self




第 5 步，设置逆地理编码查询参数

进行逆地编码时，请求参数类为 AMapReGeocodeSearchRequest，location为必设参数。



Objective-CSwift


AMapReGeocodeSearchRequest *regeo = [[AMapReGeocodeSearchRequest alloc] init]; regeo.location = [AMapGeoPoint locationWithLatitude:coordinate.latitude longitude:coordinate.longitude]; regeo.requireExtension = YES;

let request = AMapReGeocodeSearchRequest() request.location = AMapGeoPoint.location(withLatitude: CGFloat(coordinate.latitude), longitude: CGFloat(coordinate.longitude)) request.requireExtension = true




第 6 步，发起逆地理编码查询

调用 AMapSearchAPI 的 AMapReGoecodeSearch 并发起逆地理编码。



Objective-CSwift


[self.search AMapReGoecodeSearch:regeo];

search.aMapReGoecodeSearch(request)




第 7 步，在回调中处理数据

当逆地理编码成功时，会进到 onReGeocodeSearchDone 回调函数中，通过解析 AMapReGeocodeSearchResponse 获取这个点的地址信息（包括：标准化的地址、附近的POI、面区域 AOI、道路 Road等）。

1）可以在回调中解析 response，获取地址信息。

2）通过 response.regeocode 可以获取到逆地理编码对象 AMapReGeocode。

3）通过 AMapReGeocode.formattedAddress 返回标准化的地址，AMapReGeocode.addressComponent 返回地址组成要素，包括：省名称、市名称、区县名称、乡镇街道等。

4）AMapReGeocode.roads 返回地理位置周边的道路信息。

5）AMapReGeocode.pois 返回地理位置周边的POI（大型建筑物，方便定位）。

6）AMapReGeocode.aois 返回地理位置所在的AOI（兴趣区域）。



Objective-CSwift


/* 逆地理编码回调. */ - (void)onReGeocodeSearchDone:(AMapReGeocodeSearchRequest *)request response:(AMapReGeocodeSearchResponse *)response { if (response.regeocode != nil) { //解析response获取地址描述，具体解析见 Demo } }

func onReGeocodeSearchDone(_ request: AMapReGeocodeSearchRequest!, response: AMapReGeocodeSearchResponse!) { if response.regeocode == nil { return } //解析response获取地址描述，具体解析见 Demo }




说明

当检索失败时，会进入 didFailWithError 回调函数，通过该回调函数获取产生的失败的原因。



Objective-CSwift


- (void)AMapSearchRequest:(id)request didFailWithError:(NSError *)error { NSLog(@"Error: %@", error); }

func aMapSearchRequest(_ request: Any!, didFailWithError error: Error!) { print("Error:\(error)") }
















本页目录

地理编码（地址转坐标）

地理编码基本介绍

使用地理编码

第 1 步，引入头文件

第 2 步，配置Key

第 3 步，定义 AMapSearchAPI

第 4 步，构造 AMapSearchAPI

第 5 步，设置地理编码查询参数

第 6 步，发起地理编码查询

第 7 步，在回调中处理数据

逆地理编码（坐标转地址）

逆地理编码基本介绍

使用逆地理编码

第 1 步，引入头文件

第 2 步，配置Key

第 3 步，定义 AMapSearchAPI

第 4 步，构造 AMapSearchAPI

第 5 步，设置逆地理编码查询参数

第 6 步，发起逆地理编码查询

第 7 步，在回调中处理数据

说明








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

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

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

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


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

京公网安备 11010502056787号



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


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