高德搜索POI

高德搜索POI

專用API
【更新時間: 2024.03.04】 搜索服務API是一類簡單的HTTP接口,提供多種查詢POI信息的能力,其中包括關鍵字搜索、周邊搜索、多邊形搜索、ID查詢四種篩選機制。
瀏覽次數
91
采購人數
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
>