使用 Landmark API 解鎖豐富的地標資料：功能、用途等-js教程-PHP中文網

Unlock Rich Landmark Data with the Landmark API: Features, Usage, and More

建立地標 API：利用位置資料增強您的旅行應用程式？

身為開發人員，您可能會遇到需要有關地點、地標或興趣點的豐富結構化資料的情況。無論您是在建立旅遊應用程式、基於位置的服務還是旅遊網站，存取記錄齊全且可靠的地標資料都至關重要。這就是我們建立Landmark API的原因——一個強大的、可擴展的API，供開發者獲取有關全球地標的詳細資料。

在這篇文章中，我將向您介紹 Landmark API 提供的功能、如何開始以及它如何增強您的下一個專案。

為什麼選擇地標 API？

許多服務提供某種形式的位置數據，但它們通常缺乏更複雜的應用程式所需的深度。我們的 API 專注於地標並提供以下詳細資訊：

歷史與文化意義：超越基礎的描述。
地理位置資料：精確座標，可用於繪製地圖或地理圍欄。
遊客資訊：開放時間、票價、附近設施等等。
即時數據（專業版功能）：即時天氣更新、人群密度和當地公共交通。

我們的目標是為您提供幫助使用者發現和探索世界各地標誌性地點所需的所有資訊。

主要特點

1. 全面的地標細節

每個地標都帶有結構化資料：

ID：唯一識別碼。
名稱：官方地標名稱。
位置：包含國家、城市和 GPS 座標。
類別：無論是歷史、文化、自然或現代。
描述：了解該地標的歷史與意義。
圖片：令人驚嘆的照片，幫助用戶直觀地了解該地點。

2. 過濾和排序

您可以透過以下方式搜尋並篩選地標：

國家：檢索特定國家/地區的所有地標。
城市：取得某個城市的地標。
類別：對歷史名勝或現代建築奇蹟有興趣？按類別過濾！
名稱搜尋：依名稱或部分符合尋找地標。

3. 專業用戶的進階功能

對於尋求更深入見解的用戶，Pro 計畫提供：

每天 10,000 個請求（免費用戶為 1,000 個）。
即時數據：取得有關天氣、當地交通和人群規模的即時更新。
優先支援：更快回應技術查詢。
增強的效能：自訂API端點和優先權速率限制。

4. 簡單快速的搜索

此 API 允許開發人員使用靈活的參數實作自訂搜尋。您可以根據以下條件進行搜尋：

座標和半徑：找出離給定點特定距離內的地標。
自訂過濾：結合國家、城市和類別過濾器來深入分析結果。

幾分鐘內即可開始

可以輕鬆地將 Landmark API 整合到您的專案中。方法如下：

註冊：前往我們的網站並建立帳戶。
API 金鑰：產生您的 API 金鑰並立即開始發出請求。
文檔：查看詳細文檔，其中包括範例程式碼片段、端點描述和錯誤處理技巧。

依名稱擷取一個地標的請求範例：

GET /api/v1/landmarks/name/{name}

登入後複製

回應範例：

[
 {
  "data": [
    {
      "name": "Mount Fuji",
      "latitude": 35.3606,
      "longitude": 138.7274,
      "category": "Natural Landmark",
      "country": "Japan",
      "description": "Mount Fuji is the highest mountain in Japan, an active stratovolcano and one of the country's iconic symbols.",
      "id": "7f3fabf9-a410-4f07-ba7c-4e3723b3a194",
      "images": [
        {
          "image_url": "https://properties-photos.s3.amazonaws.com/landmarks/7a285aaefd0dcdadcde62819d731c21af5462d64d5c4ec02ba9ceee9b/api/v1/landmarks/upload-photo/R (2)_20241016173821_ac70cbc2.jpg",
          "created_at": "2024-10-16T17:43:16.551837Z",
          "updated_at": "2024-10-16T17:43:16.551837Z"
        },
        {
          "image_url": "https://properties-photos.s3.amazonaws.com/landmarks/7a285aaefd0dcdadcde62819d731c21af5462d64d5c4ec02ba9ceee9b/api/v1/landmarks/upload-photo/R (1)_20241016173823_ba2efda8.jpg",
          "created_at": "2024-10-16T17:43:16.551837Z",
          "updated_at": "2024-10-16T17:43:16.551837Z"
        },
        {
          "image_url": "https://properties-photos.s3.amazonaws.com/landmarks/7a285aaefd0dcdadcde62819d731c21af5462d64d5c4ec02ba9ceee9b/api/v1/landmarks/upload-photo/OIP (2)_20241016173824_26bcb482.jpg",
          "created_at": "2024-10-16T17:43:16.551837Z",
          "updated_at": "2024-10-16T17:43:16.551837Z"
        },
        {
          "image_url": "https://properties-photos.s3.amazonaws.com/landmarks/7a285aaefd0dcdadcde62819d731c21af5462d64d5c4ec02ba9ceee9b/api/v1/landmarks/upload-photo/R_20241016173824_9b8d4f1e.jpg",
          "created_at": "2024-10-16T17:43:16.551837Z",
          "updated_at": "2024-10-16T17:43:16.551837Z"
        },
      ],
      "accessibility_info": "Accessible by bus or car to the 5th Station for non-climbers.",
      "opening_hours": {
        "Friday": "24/7, official climbing season July to early Semptember",
        "Monday": "24/7, official climbing season July to early Semptember",
        "Saturday": "24/7, official climbing season July to early Semptember",
        "Sunday": "24/7, official climbing season July to early Semptember",
        "Thursday": "24/7, official climbing season July to early Semptember",
        "Tuesday": "24/7, official climbing season July to early Semptember",
        "Wednesday": "24/7, official climbing season July to early Semptember"
      },
      "visitor_tips": "Climbers should prepare for rapid weather changes and pack warm clothes, food, and water.",
      "weather_info": {
        "main": {
          "temp": 4.84
        },
        "weather": [
          {
            "description": "broken clouds"
          }
        ]
      }
    }
  ],
  "meta": {
    "total": 1
  }
}
  ...
]

登入後複製