高德搜索POI

高德搜索POI

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

什么是高德搜索POI?

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

高德搜索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
>