高德搜索POI

高德搜索POI

专用API
【更新时间: 2024.03.04】 搜索服务API是一类简单的HTTP接口,提供多种查询POI信息的能力,其中包括关键字搜索、周边搜索、多边形搜索、ID查询四种筛选机制。
服务星级:6星
⭐ ⭐ ⭐ ⭐ ⭐ ⭐ 🌟
浏览次数
56
采购人数
2
试用次数
0
! SLA: N/A
! 响应: N/A
! 适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
<
产品介绍
>

什么是高德搜索POI?

高德地图搜索POI高级API服务是一种强大的地理信息服务工具,旨在帮助开发者和企业快速获取和处理位置信息。通过该服务,用户可以基于关键字、地理位置、行政区划等多种条件查询兴趣点(POI)信息,并获取详细的返回数据。服务支持多种查询方式,包括关键字搜索、周边搜索、多边形搜索、ID查询以及AOI边界查询等,能够满足不同场景下的位置信息需求。此外,该服务还提供了丰富的扩展功能,如返回附近POI、道路信息以及室内地图数据等,极大地提升了位置信息的应用价值和用户体验。

 

什么是高德搜索POI接口?

由服务使用方的应用程序发起,以Restful风格为主、通过公网HTTP协议调用高德搜索POI,从而实现程序的自动化交互,提高服务效率。

高德搜索POI有哪些核心功能?

  1. 关键字搜索:通过关键字(如“肯德基”“银行”)查询POI信息。支持指定城市范围(如城市名称、citycode或adcode),并可设置返回结果的详细程度(如基本地址信息或完整信息)。用户还可以通过分页参数(如offset和page)控制返回结果的数量和页码。关键字搜索功能强大,能够满足用户对特定类型POI的查询需求,同时支持模糊匹配和智能联想,提升查询效率。
  2. 周边搜索:在指定的经纬度坐标点附近,按照关键字或POI类型进行搜索。用户可以设置搜索半径(0-50000米),并选择排序规则(如按距离或权重排序)。周边搜索功能特别适用于基于用户当前位置的场景,如查找附近的餐厅、加油站、酒店等,为用户提供便捷的位置信息服务。
  3. 多边形搜索:在指定的多边形区域内进行POI搜索。用户可以通过传入多边形的顶点坐标(经纬度)来定义搜索区域,支持矩形和其他多边形区域的搜索。多边形搜索功能适用于复杂区域的POI查询,如在某个特定区域内查找特定类型的设施,为地理信息系统和区域分析提供支持。
  4. ID查询:通过POI的唯一ID查询详细的POI信息。用户可以获取POI的详细地址、经纬度、电话、周边设施等信息,适合需要精确查询特定POI的场景。
  5. AOI边界查询:查询特定AOI(Area of Interest,兴趣区域)的边界信息。返回结果包括区域的名称、中心点坐标、边界坐标串等。该功能适用于需要对地理区域进行管理和分析的场景,如商圈分析、地理围栏等。

高德搜索POI的核心优势是什么?

  1. 丰富的查询方式:提供关键字搜索、周边搜索、多边形搜索等多种查询方式,满足不同场景下的位置信息需求。用户可以根据具体需求选择合适的查询方式,获取精准的POI数据。
  2. 灵活的参数配置:支持多种参数配置,如分页参数、返回结果控制参数(如extensions=all)、排序规则等。用户可以根据需求调整返回结果的数量、格式和排序方式,提升查询效率和用户体验。
  3. 强大的数据覆盖:高德地图拥有海量的POI数据,覆盖全国范围内的各种类型设施。无论是餐饮、酒店、交通设施还是生活服务,都能提供详细的查询结果,满足用户多样化的需求。
  4. 高精度的地理位置信息:返回的POI数据包含精确的经纬度信息,支持多种坐标系。用户可以将这些数据直接应用于地图展示、导航或其他地理信息系统中,确保位置信息的准确性和可靠性。
  5. 扩展性强:支持返回附近POI、道路信息、室内地图数据等扩展信息,为开发者提供了丰富的数据资源。用户可以根据需求选择不同的扩展信息,提升应用的功能性和用户体验。

高德搜索POI有哪些使用限制?

  1. 服务调用量的限制需要根据高德开放平台的流量限制说明进行查阅。用户需要根据自身的使用场景和需求,合理规划调用频率和数量,避免超出限制。
  2. 在某些高级功能(如AOI边界查询)的使用上,可能需要通过工单申请开通权限。用户需要提前与高德开放平台联系,确保能够正常使用相关功能。

在哪些场景会用到高德搜索POI?

1. 地图导航应用

在地图导航应用中,开发者可以通过周边搜索功能获取用户当前位置附近的POI信息,如加油站、餐厅、酒店等,为用户提供便捷的导航和位置服务。用户可以根据搜索结果选择目的地,并获取详细的导航路线,提升出行效率。

 

 

2. 地理信息系统(GIS)

在地理信息系统中,多边形搜索功能可以用于分析特定区域内的POI分布情况,如在某个商圈内查找特定类型的店铺。通过获取这些数据,用户可以进行区域规划、市场分析等操作,为决策提供支持。

 

 

3. 位置信息服务

在位置信息服务中,关键字搜索功能可以帮助用户快速查找特定类型的POI,如“附近的医院”“附近的银行”等。用户可以根据查询结果获取详细信息,如地址、电话、营业时间等,满足日常生活中的位置信息需求。

 

 

4. 智能交通系统

在智能交通系统中,周边搜索功能可以用于查找附近的交通设施,如停车场、公交站、地铁站等。通过获取这些信息,用户可以规划最优出行路线,缓解交通拥堵,提升交通效率。

 

 

5. 商业智能分析

在商业智能分析中,AOI边界查询功能可以用于分析特定商圈或区域的边界信息,结合POI数据进行市场分析、竞争分析等。用户可以通过这些数据了解区域内的商业分布情况,为商业决策提供依据。

 

 

6. 移动应用开发

在移动应用开发中,开发者可以将高德地图搜索POI高级API集成到应用中,为用户提供位置相关的功能,如查找附近的商家、预订服务等。通过调用API,用户可以获取实时的POI信息,提升应用的实用性和用户体验。

 

<
使用指南
>

高德搜索POI服务API使用指南

1. 注册与获取API Key

  • 访问高德开放平台,注册成为开发者。
  • 申请Web服务API的Key,确保在后续API请求中使用。

2. API接口概述

高德地图提供多种API接口用于查询POI(兴趣点)信息,主要包括:

  • 关键字搜索:根据关键字查找POI。
  • 周边搜索:在指定经纬度附近查找POI。
  • 多边形搜索:在指定多边形区域内查找POI。
  • ID查询:通过POI ID获取详细信息。

3. 关键字搜索

3.1 请求方式

  • URL: https://restapi.amap.com/v3/place/text
  • 请求方法: GET

3.2 使用步骤

  1. 拼接请求URL,包含必需的API Key和查询关键字。
  2. 可选地指定城市、类型、分页等参数。
  3. 发送请求并接收返回的数据。

3.3 示例

https://restapi.amap.com/v3/place/text?keywords=北京大学&city=北京&key=<用户的key>

4. 周边搜索

4.1 请求方式

  • URL: https://restapi.amap.com/v3/place/around
  • 请求方法: GET

4.2 使用步骤

  1. 提供中心点的经纬度坐标。
  2. 拼接请求URL,包含必需的API Key和其他可选参数(如关键字、半径等)。
  3. 发送请求并接收返回的数据。

4.3 示例

https://restapi.amap.com/v3/place/around?key=<用户的key>&location=116.481488,39.990464&radius=1000

5. 多边形搜索

5.1 请求方式

  • URL: https://restapi.amap.com/v3/place/polygon
  • 请求方法: GET

5.2 使用步骤

  1. 定义多边形区域的经纬度坐标。
  2. 拼接请求URL,包含必需的API Key和可选参数(如关键字)。
  3. 发送请求并接收返回的数据。

5.3 示例

https://restapi.amap.com/v3/place/polygon?polygon=116.460988,40.006919|116.48231,40.007381|116.47516,39.99713|116.460988,40.006919&key=<用户的key>

6. ID查询

6.1 请求方式

  • URL: https://restapi.amap.com/v3/place/detail
  • 请求方法: GET

6.2 使用步骤

  1. 获取目标POI的ID。
  2. 拼接请求URL,包含必需的API Key和POI ID。
  3. 发送请求并接收返回的数据。

6.3 示例

https://restapi.amap.com/v3/place/detail?id=B0FFFAB6J2&key=<用户的key>

7. 其他注意事项

  • 所有请求均需使用UTF-8编码。
  • 根据需要合理设置分页和结果数量,避免请求过多导致错误。
  • 请遵循高德开放平台的使用限制和政策。

 

详情查看链接:https://lbs.amap.com/api/webservice/guide/api-advanced/search

<
产品问答
>
?
Web服务API接口访问超时的问题如何解决?
1、先确认是链接超时还是响应超时? 2、响应超时时,可能是网络问题,需要您提供完整请求串和请求发生的时间点给我们。 3、链接超时时,多数情况下是您网络环境存在问题,请排查您的网络环境。 4、排查确认是访问我们的一个接口超时还是所有接口都超时,如果所有的接口都出现超时,极大可能是网络问题,需要提供完整请求和请求发生的时间点给我们;如果是一个接口超时,排除网络因素,需要按下方要求提供对应的信息给我们。
?
Web服务API访问出错怎么办?
当您遇到Web服务API访问出错的情况,请您先对照错误码表,查询您的错误原因和解决方案。 如仍然无法解决您的问题,请按照以下格式提交工单,我们会尽快为您解决。 Key: 完整请求串: 请求时间(尽量精确到秒): 返回的错误信息: 请求响应的Header信息 (可选,建议添加,便于追查问题记录):
?
城市编码&POI分类编码表如何获取?
请在Web服务 API 相关下载进行下载。
?
Web服务API请求报错怎么办?
如果您在使用API的时候出现了报错,您可以通过错误编码表进行查阅原因。 如果您确认是量级不够,可以点此查看此接口能够支持的量级。
?
IP白名单为什么要设置?
申请了Web服务类型的Key,在配置选项中,有一个“IP白名单”配置项。此项为非必填,但强烈建议用户在线上正常使用时为Key设置一个IP白名单。 设置IP白名单后,只有来自于白名单列表内的请求,才能被高德服务器正常响应,返回预期结果。否则将会提示“ 10005 INVALID_USER_IP”的错误。这样做的目的,是为了保证用户的使用安全。即便发生Key泄露的情况,其他用户也无法正常使用。 如果其他用户也可以调用,第一消耗账号的配额,其次有可能被我们的监控系统自动识别为“非法调用”,受到限制后,会影响正常用户的正常使用。
?
Web服务API的申请需要注意什么?
有两点需要注意: 1、申请高德Web服务API,为了您的使用安全,建议为Key绑定IP白名单。这样,只有来自于IP白名单的请求,才会被正常响应。此处IP白名单中的IP,是指使用者服务器出口的IP。 2、请各位合作伙伴注意:使用高德Web服务API,严禁做压力测试,如擅自做压力测试,系统立即会识别出来,并自动封停服务。由此引发的损失需要您自行承担。
?
请求串在IE、服务器中参数返回为空怎样解决?
如果您的请求串在chrome之中能够得到符合预期的返回,但是在IE、服务器之中得到返回的内容为空。 很有可能是您的请求串没有urlencode而导致IE、服务器不识别,故建议您将请求串进行urlencode之后再进行尝试。 例如: urlencode之前:http://restapi.amap.com/v3/geocode/geo?address=济南高新万达&output=XML&key=<您的key>&city=济南 urlencode之后:http://restapi.amap.com/v3/geocode/geo?address=%E6%B5%8E%E5%8D%97%E9%AB%98%E6%96%B0%E4%B8%87%E8%BE%BE&output=XML&key=<您的key>&city=%E6%B5%8E%E5%8D%97 另外在此需要特别指出,若使用批量模式时,address使用urlencode不能把“|”分隔符一起转义,否则报错。
<
关于我们
>
高德软件有限公司是中国领先的数字地图内容、导航和位置服务提供商。自2002年成立以来,公司一直致力于为用户和企业提供基于位置的解决方案。高德拥有海量的地图数据和先进的定位技术,提供包括地图展示、路线规划、导航服务、地理编码等在内的多种API服务。同时,高德还推出了面向不同平台的SDK,如Android、iOS和鸿蒙星河版,满足开发者在移动应用开发中对地图功能的需求。通过不断的技术创新和服务优化,高德软件有限公司已成为中国位置服务领域的领军企业。
联系信息

高德开放平台是国内技术优质的LBS服务提供商,拥有先进的数据融合技术和海量的数据处理能力。服务超过三十万款移动应用,日均处理定位请求及路径规划数百亿次。高德开放平台向广大开发者提供覆盖移动端和Web端的开发工具,开发者通过调用开发包或接口即可在应用或网页中实现地图显示、标注、位置检索等功能。使得LBS应用的开发过程更加容易。

高德正在进行的位置大数据探索与实践,高德地图开放平台通过其服务的三十万款应用,每日百亿级的位置请求和相关行为,对现实世界做了人群走向、区域热度、行为偏好等分析和洞察,试图通过数据画像还原一个在我们身边熟悉却又陌生的世界。

<
最可能同场景使用的其他API
>
API接口列表
关键字搜索
周边搜索
多边形搜索
ID查询
AOI边界查询
关键字搜索
1.1 简要描述
通过用POI的关键字进行条件搜索,例如:肯德基、朝阳公园等;同时支持设置POI类型搜索,例如:银行
1.2 请求URL
https://restapi.amap.com/v3/place/text?parameters
1.3 请求方式
GET
1.4 入参
参数名 参数类型 默认值 是否必传 描述
1.5 出参
参数名 参数类型 默认值 描述
1.6 错误码
错误码 错误信息 描述
1.7 示例



				
周边搜索
2.1 简要描述
在用户传入经纬度坐标点附近,在设定的范围内,按照关键字或POI类型搜索;
2.2 请求URL
https://restapi.amap.com/v3/place/around?parameters
2.3 请求方式
GET
2.4 入参
参数名 参数类型 默认值 是否必传 描述
2.5 出参
参数名 参数类型 默认值 描述
2.6 错误码
错误码 错误信息 描述
2.7 示例



				
多边形搜索
3.1 简要描述
在多边形区域内进行搜索
3.2 请求URL
https://restapi.amap.com/v3/place/polygon?parameters
3.3 请求方式
GET
3.4 入参
参数名 参数类型 默认值 是否必传 描述
3.5 出参
参数名 参数类型 默认值 描述
3.6 错误码
错误码 错误信息 描述
3.7 示例



				
ID查询
4.1 简要描述
通过POI ID,查询某个POI详情,建议可同输入提示API配合使用
4.2 请求URL
https://restapi.amap.com/v3/place/detail?parameters
4.3 请求方式
GET
4.4 入参
参数名 参数类型 默认值 是否必传 描述
4.5 出参
参数名 参数类型 默认值 描述
4.6 错误码
错误码 错误信息 描述
4.7 示例



				
AOI边界查询
5.1 简要描述
该服务属于高德开放平台高阶服务,您在正式使用前需要通过工单等形式联系我们开通权限。
5.2 请求URL
https://restapi.amap.com/v5/aoi/polyline?parameters
5.3 请求方式
GET
5.4 入参
参数名 参数类型 默认值 是否必传 描述
5.5 出参
参数名 参数类型 默认值 描述
5.6 错误码
错误码 错误信息 描述
5.7 示例



				
<
使用指南
>

高德搜索POI服务API使用指南

1. 注册与获取API Key

  • 访问高德开放平台,注册成为开发者。
  • 申请Web服务API的Key,确保在后续API请求中使用。

2. API接口概述

高德地图提供多种API接口用于查询POI(兴趣点)信息,主要包括:

  • 关键字搜索:根据关键字查找POI。
  • 周边搜索:在指定经纬度附近查找POI。
  • 多边形搜索:在指定多边形区域内查找POI。
  • ID查询:通过POI ID获取详细信息。

3. 关键字搜索

3.1 请求方式

  • URL: https://restapi.amap.com/v3/place/text
  • 请求方法: GET

3.2 使用步骤

  1. 拼接请求URL,包含必需的API Key和查询关键字。
  2. 可选地指定城市、类型、分页等参数。
  3. 发送请求并接收返回的数据。

3.3 示例

https://restapi.amap.com/v3/place/text?keywords=北京大学&city=北京&key=<用户的key>

4. 周边搜索

4.1 请求方式

  • URL: https://restapi.amap.com/v3/place/around
  • 请求方法: GET

4.2 使用步骤

  1. 提供中心点的经纬度坐标。
  2. 拼接请求URL,包含必需的API Key和其他可选参数(如关键字、半径等)。
  3. 发送请求并接收返回的数据。

4.3 示例

https://restapi.amap.com/v3/place/around?key=<用户的key>&location=116.481488,39.990464&radius=1000

5. 多边形搜索

5.1 请求方式

  • URL: https://restapi.amap.com/v3/place/polygon
  • 请求方法: GET

5.2 使用步骤

  1. 定义多边形区域的经纬度坐标。
  2. 拼接请求URL,包含必需的API Key和可选参数(如关键字)。
  3. 发送请求并接收返回的数据。

5.3 示例

https://restapi.amap.com/v3/place/polygon?polygon=116.460988,40.006919|116.48231,40.007381|116.47516,39.99713|116.460988,40.006919&key=<用户的key>

6. ID查询

6.1 请求方式

  • URL: https://restapi.amap.com/v3/place/detail
  • 请求方法: GET

6.2 使用步骤

  1. 获取目标POI的ID。
  2. 拼接请求URL,包含必需的API Key和POI ID。
  3. 发送请求并接收返回的数据。

6.3 示例

https://restapi.amap.com/v3/place/detail?id=B0FFFAB6J2&key=<用户的key>

7. 其他注意事项

  • 所有请求均需使用UTF-8编码。
  • 根据需要合理设置分页和结果数量,避免请求过多导致错误。
  • 请遵循高德开放平台的使用限制和政策。

 

详情查看链接:https://lbs.amap.com/api/webservice/guide/api-advanced/search

<
依赖服务
>
<
产品问答
>
?
Web服务API接口访问超时的问题如何解决?
1、先确认是链接超时还是响应超时? 2、响应超时时,可能是网络问题,需要您提供完整请求串和请求发生的时间点给我们。 3、链接超时时,多数情况下是您网络环境存在问题,请排查您的网络环境。 4、排查确认是访问我们的一个接口超时还是所有接口都超时,如果所有的接口都出现超时,极大可能是网络问题,需要提供完整请求和请求发生的时间点给我们;如果是一个接口超时,排除网络因素,需要按下方要求提供对应的信息给我们。
?
Web服务API访问出错怎么办?
当您遇到Web服务API访问出错的情况,请您先对照错误码表,查询您的错误原因和解决方案。 如仍然无法解决您的问题,请按照以下格式提交工单,我们会尽快为您解决。 Key: 完整请求串: 请求时间(尽量精确到秒): 返回的错误信息: 请求响应的Header信息 (可选,建议添加,便于追查问题记录):
?
城市编码&POI分类编码表如何获取?
请在Web服务 API 相关下载进行下载。
?
Web服务API请求报错怎么办?
如果您在使用API的时候出现了报错,您可以通过错误编码表进行查阅原因。 如果您确认是量级不够,可以点此查看此接口能够支持的量级。
?
IP白名单为什么要设置?
申请了Web服务类型的Key,在配置选项中,有一个“IP白名单”配置项。此项为非必填,但强烈建议用户在线上正常使用时为Key设置一个IP白名单。 设置IP白名单后,只有来自于白名单列表内的请求,才能被高德服务器正常响应,返回预期结果。否则将会提示“ 10005 INVALID_USER_IP”的错误。这样做的目的,是为了保证用户的使用安全。即便发生Key泄露的情况,其他用户也无法正常使用。 如果其他用户也可以调用,第一消耗账号的配额,其次有可能被我们的监控系统自动识别为“非法调用”,受到限制后,会影响正常用户的正常使用。
?
Web服务API的申请需要注意什么?
有两点需要注意: 1、申请高德Web服务API,为了您的使用安全,建议为Key绑定IP白名单。这样,只有来自于IP白名单的请求,才会被正常响应。此处IP白名单中的IP,是指使用者服务器出口的IP。 2、请各位合作伙伴注意:使用高德Web服务API,严禁做压力测试,如擅自做压力测试,系统立即会识别出来,并自动封停服务。由此引发的损失需要您自行承担。
?
请求串在IE、服务器中参数返回为空怎样解决?
如果您的请求串在chrome之中能够得到符合预期的返回,但是在IE、服务器之中得到返回的内容为空。 很有可能是您的请求串没有urlencode而导致IE、服务器不识别,故建议您将请求串进行urlencode之后再进行尝试。 例如: urlencode之前:http://restapi.amap.com/v3/geocode/geo?address=济南高新万达&output=XML&key=<您的key>&city=济南 urlencode之后:http://restapi.amap.com/v3/geocode/geo?address=%E6%B5%8E%E5%8D%97%E9%AB%98%E6%96%B0%E4%B8%87%E8%BE%BE&output=XML&key=<您的key>&city=%E6%B5%8E%E5%8D%97 另外在此需要特别指出,若使用批量模式时,address使用urlencode不能把“|”分隔符一起转义,否则报错。
<
关于我们
>
高德软件有限公司是中国领先的数字地图内容、导航和位置服务提供商。自2002年成立以来,公司一直致力于为用户和企业提供基于位置的解决方案。高德拥有海量的地图数据和先进的定位技术,提供包括地图展示、路线规划、导航服务、地理编码等在内的多种API服务。同时,高德还推出了面向不同平台的SDK,如Android、iOS和鸿蒙星河版,满足开发者在移动应用开发中对地图功能的需求。通过不断的技术创新和服务优化,高德软件有限公司已成为中国位置服务领域的领军企业。
联系信息

高德开放平台是国内技术优质的LBS服务提供商,拥有先进的数据融合技术和海量的数据处理能力。服务超过三十万款移动应用,日均处理定位请求及路径规划数百亿次。高德开放平台向广大开发者提供覆盖移动端和Web端的开发工具,开发者通过调用开发包或接口即可在应用或网页中实现地图显示、标注、位置检索等功能。使得LBS应用的开发过程更加容易。

高德正在进行的位置大数据探索与实践,高德地图开放平台通过其服务的三十万款应用,每日百亿级的位置请求和相关行为,对现实世界做了人群走向、区域热度、行为偏好等分析和洞察,试图通过数据画像还原一个在我们身边熟悉却又陌生的世界。

<
合作案例
>

<
最可能同场景使用的其他API
>