Geoapify Places API 是一項服務，它使開發人員能夠以編程方式搜索和檢索有關地點和興趣點的信息。它提供對龐大位置數據庫的訪問，使您可以將地點搜索功能整合到您的應用程序和網站中。

1.支持的類別

我們廣泛的地點類別列表不斷增加，目前已支持 500 多個類別，并且還在不斷擴展。此外，我們的類別是分層的，可讓您在頂級搜索或更具體的搜索之間進行選擇。

探索此處提供的完整類別列表，開啟定制和精確地點搜索的無限可能。

2.尋找合適地點的條件

除了廣泛的類別選項外，API 還允許您指定地點應遵守的條件。以下是在 Places API 查詢中組合類別和條件的幾個示例：

• 查找免費停車位：將類別“停車”與條件“免費”相結合，即可搜索提供免費停車的地點。輕松找到方便且經濟實惠的停車選擇。
• 素食者友好型互聯網接入：使用類別“catering.restaurant”以及條件（如“internet_access”和“vegan.only”）來查找提供互聯網接入并專門供應素食的餐廳。享受滿足您特定偏好的用餐體驗。
• 適合狗狗的旅游景點：將類別“tourism.sights”與條件“dogs”相結合，即可找到適合狗狗的旅游景點。探索新目的地，同時確保您的寵物受到歡迎。

通過訪問此處的列表來了解所支持的全部條件，并解鎖定制和個性化地點搜索的無限可能性。

3.位置過濾器和偏向

Places API 提供了強大的位置過濾器和偏差選項來微調您的位置查詢 - 搜索邊界框或半徑內的地點，發現可達區域，并根據接近度精確定位位置。

4.獲取地點詳細信息

要獲取每個地點的全面信息，您可以使用地點詳情 API，該 API 允許您請求地點 API 返回的有關特定地點的詳細數據。

地點詳情 API 為您提供地點的幾何形狀，其中包含豐富的結構化數據，可提供有關該地點各個方面的寶貴見解，例如其地址、聯系信息、營業時間等。通過利用地點詳情 API，您可以訪問深入的結構化信息，以增強應用的功能，并在用戶探索和與地點互動時為他們提供更豐富的體驗。

1.全面的數據覆蓋：

Geoapify提供全球范圍內的地理數據，確保用戶能夠在任何地方獲得準確和詳細的地點信息。

2.高精度和高性能：

提供高精度的地理位置和路線規劃，確保數據的準確性和實時性，同時通過優化的查詢算法提升響應速度。

3.豐富的POI數據：

提供詳細的興趣點（Points of Interest, POI）數據，包括餐館、酒店、加油站、銀行等多個類別，支持多維度的地點搜索。

4.自定義和靈活性：

支持自定義查詢參數，如語言、結果數量、偏好設置等，滿足特定應用的需求。

5.易于集成：

提供簡單易用的API接口和詳細的文檔，方便開發者快速集成到自己的應用或服務中。

6.強大的數據更新機制：

定期更新地理和POI數據，確保用戶獲得最新的信息。

7.數據隱私和安全：

重視用戶數據隱私，采用安全的數據傳輸和存儲機制，保障用戶數據安全。

1.基于位置的推薦：通過為用戶當前位置附近的餐廳、景點和住宿提供個性化推薦，增強您的旅行應用。例如，“根據您當前的位置發現附近的高評分餐廳和熱門景點。”

2.旅行規劃：通過集成 Places API 為用戶提供目的地景點、餐廳和住宿的詳細信息，從而促進旅行規劃。例如，“通過探索您理想旅行目的地的熱門景點、頂級餐廳和推薦酒店來規劃您的夢想假期。”

3.企業查找器：創建本地企業目錄，允許用戶搜索特定類型的企業，例如“查找您所在地區最近的寵物美容服務”。

4.路線規劃：通過集成 Places API 來識別沿途的加油站、休息站和餐飲選擇，從而優化路線規劃。例如，“使用詳細的路線建議規劃您的公路旅行，包括附近的加油站和餐館。”

5.房地產搜索：整合 Places API，幫助用戶查找特定位置附近且配備所需設施的房產。例如，“探索您喜歡的社區內學校、公園和購物中心附近的待售房屋。”

6.基于地理位置的營銷：根據用戶與特定地點的距離，向用戶提供優惠和促銷活動，從而開展基于位置的營銷活動。例如，“使用我們基于位置的優惠，解鎖附近咖啡店的專屬折扣。”

7.緊急服務定位器：集成 Places API，在緊急情況下快速定位附近的醫院、警察局和緊急服務。例如，“在緊急情況下查找最近的醫院和醫療機構。”

8.城市指南：制作全面的城市指南，提供有關景點、歷史地標、交通選擇等的信息。例如，“瀏覽我們的城市指南，了解必游地標、隱藏的瑰寶和當地交通提示。”

9.寵物友好地點：創建一款應用，幫助寵物主人在與寵物一起旅行時找到寵物友好公園、咖啡館和酒店。例如，“發現您附近適合寵物的公園，與您的四條腿朋友一起享受有趣的郊游。”

10.戶外活動：幫助戶外運動愛好者找到附近的徒步小徑、公園、露營地和其他戶外休閑活動。例如，“發現附近的徒步小徑、公園和露營地，為您的下一次戶外探險做好準備。”

要開始在您的應用程序中使用 Geoapify Places API，請按照以下步驟操作：

1. 注冊并獲取 API 憑證

在 Geoapify 網站上注冊一個帳戶以接收您的 API 憑證，包括 API 密鑰。此密鑰將用于驗證您對 Places API 的請求。

訪問我們的地圖 API 入門頁面，了解有關 Geoapify 帳戶和 API 密鑰的更多信息。

2. 構造 API 請求

深入了解Places API 文檔，其中提供了有關 API 參數的全面信息，或者使用API Playground生成請求 URL。

以下是查詢美國華盛頓特區醫療保健場所視圖框的 API URL 示例：

https://api.geoapify.com/v2/places?categories=healthcare&filter=rect:-77.03921757581298,38.90660286449031,-77.01762874146101,38.88987145915573&limit=100&apiKey=YOUR_API_KEY

3. 發送 API 請求

Places API 通過 HTTP Get 請求工作。使用編程語言的相應 HTTP 客戶端庫將 API 請求發送到指定端點。在每個請求中包含您的 API 密鑰作為身份驗證標頭或查詢參數。

以下是發送 API 請求的代碼示例：

fetch('https://api.geoapify.com/v2/places?categories=commercial&filter=rect:7.735282,48.586797,7.756289,48.574457&limit=200&apiKey=YOUR_API_KEY')
.then(resp => resp.json())
.then((places) => {
	console.log(places);
});

4.處理 API 響應

在您的應用程序中捕獲 API 響應并進行相應處理。響應將包含GeoJSON格式的請求地點數據，讓您能夠提取相關信息，例如地名、地址、坐標和所有相關地點類別。

以下是一些解決特定業務問題的 API URL 示例：

搜索慕尼黑市中心可見區域內的餐廳

讓我們搜索慕尼黑市中心的 100 家餐廳。我們將查詢“catering.restaurant”類別。以下是可以完成此工作的 URL：

https://api.geoapify.com/v2/places?categories=catering.restaurant&filter=rect:11.549881365729718,48.15114774722076,11.58831616443861,48.12837326392079&limit=100&apiKey=YOUR_API_KEY

搜索柏林亞歷山大廣場步行 10 分鐘內的廁所

您可以通過兩個步驟找到 10 分鐘內可到達的 WC 列表：

https://api.geoapify.com/v1/isoline?lat=52.521670650000004&lon=13.413278026558228&type=time&mode=walk&range=600&apiKey=YOUR_API_KEY

https://api.geoapify.com/v2/places?categories=amenity.toilet&filter=geometry:GEOMETRY_ID&bias=proximity:13.413637435864272,52.52197645&limit=100&apiKey=YOUR_API_KEY

我們還添加與原始位置相對應的偏差，以便按接近度對結果進行排序。

查詢無障礙地點最近的50個旅游景點

我們將結合使用“tourism.sights”類別和“輪椅”條件進行查詢：

https://api.geoapify.com/v2/places?categories=tourism.sights&conditions=wheelchair&bias=proximity:7.744380838810624,48.5873243&limit=200&apiKey=YOUR_API_KEY

這些 API URL 演示了如何利用 Geoapify Places API 解決各種業務問題。將 URL 中的“YOUR_API_KEY”替換為您的實際 API 密鑰，以發出有效請求并接收所需的地點數據。