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

1.支持的類別

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

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

2.尋找合適地點的條件

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

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

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

3.位置過濾器和偏向

Places API 提供了強大的位置過濾器和偏差選項來微調(diào)您的位置查詢 - 搜索邊界框或半徑內(nèi)的地點，發(fā)現(xiàn)可達區(qū)域，并根據(jù)接近度精確定位位置。

4.獲取地點詳細信息

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

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

1.全面的數(shù)據(jù)覆蓋：

Geoapify提供全球范圍內(nèi)的地理數(shù)據(jù)，確保用戶能夠在任何地方獲得準(zhǔn)確和詳細的地點信息。

2.高精度和高性能：

提供高精度的地理位置和路線規(guī)劃，確保數(shù)據(jù)的準(zhǔn)確性和實時性，同時通過優(yōu)化的查詢算法提升響應(yīng)速度。

3.豐富的POI數(shù)據(jù)：

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

4.自定義和靈活性：

支持自定義查詢參數(shù)，如語言、結(jié)果數(shù)量、偏好設(shè)置等，滿足特定應(yīng)用的需求。

5.易于集成：

提供簡單易用的API接口和詳細的文檔，方便開發(fā)者快速集成到自己的應(yīng)用或服務(wù)中。

6.強大的數(shù)據(jù)更新機制：

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

7.數(shù)據(jù)隱私和安全：

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

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

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

3.企業(yè)查找器：創(chuàng)建本地企業(yè)目錄，允許用戶搜索特定類型的企業(yè)，例如“查找您所在地區(qū)最近的寵物美容服務(wù)”。

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

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

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

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

8.城市指南：制作全面的城市指南，提供有關(guān)景點、歷史地標(biāo)、交通選擇等的信息。例如，“瀏覽我們的城市指南，了解必游地標(biāo)、隱藏的瑰寶和當(dāng)?shù)亟煌ㄌ崾尽?rdquo;

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

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

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

1. 注冊并獲取 API 憑證

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

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

2. 構(gòu)造 API 請求

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

以下是查詢美國華盛頓特區(qū)醫(yī)療保健場所視圖框的 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. 發(fā)送 API 請求

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

以下是發(fā)送 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 響應(yīng)

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

以下是一些解決特定業(yè)務(wù)問題的 API URL 示例：

搜索慕尼黑市中心可見區(qū)域內(nèi)的餐廳

讓我們搜索慕尼黑市中心的 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 分鐘內(nèi)的廁所

您可以通過兩個步驟找到 10 分鐘內(nèi)可到達的 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

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

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

我們將結(jié)合使用“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 解決各種業(yè)務(wù)問題。將 URL 中的“YOUR_API_KEY”替換為您的實際 API 密鑰，以發(fā)出有效請求并接收所需的地點數(shù)據(jù)。