高德搜索POI

高德搜索POI

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