2. 獲取API密鑰

進去儀表盤復制API密鑰

3. 請求示例

獲取位置坐標的天文信息

您可以將位置的緯度和經度作為查詢參數lat和long傳遞，以獲取天文信息。下面是一個獲取’-27.4748，153.017’坐標的天文信息的例子：

curl 'https://api.ipgeolocation.io/astronomy?apiKey=API_KEY&lat=-27.4748&long=153.017'

輸出格式

{

  "location": {

    "latitude": -27.4748,

    "longitude": 153.017

  },

  "date": "2024-11-04",

  "current_time": "23:28:59.711",

  "sunrise": "04:54",

  "sunset": "18:08",

  "sun_status": "-",

  "solar_noon": "11:31",

  "day_length": "13:14",

  "sun_altitude": -46.89343713201794,

  "sun_distance": 148361706.39355108,

  "sun_azimuth": 180.89506040990295,

  "moonrise": "06:15",

  "moonset": "20:46",

  "moon_status": "-",

  "moon_altitude": -25.365567944837675,

  "moon_distance": 396297.670873638,

  "moon_azimuth": 214.4609302018781,

  "moon_parallactic_angle": 145.49291581261554,

  "moon_phase": "WAXING_CRESCENT",

  "moon_illumination_percentage": "8.49",

  "moon_angle": 33.87230698192152

}

4. 常見問題

Q：如何找到ipgeolocation API開放平臺

A：冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’ipgeolocation API開放平臺‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。

Q：授權方式？
A：我們提供兩種授權方式，即使用：

• API 密鑰
• 請求來源 (CORS)

Q：API 密鑰?
A：API 密鑰作為查詢參數傳遞來向我們的 API 發出授權請求。要獲取您的 API 密鑰，請登錄我們的 API 控制臺并從那里獲取您的 API 密鑰。我們強烈建議不要在客戶端 JavaScript 中使用 API 密鑰，因為這會將您的 API 密鑰公開。

為了在客戶端 JavaScript 中使用 API 密鑰，請使用請求來源 (CORS) 方法。

Q：請求來源 (CORS)?
A：此功能僅適用于付費計劃。此功能的目的是從客戶端 JavaScript 調用我們的 API，而無需使用您的 API 密鑰。

要使用此功能，請轉到應用程序控制臺并單擊儀表板/API 密鑰部分中的 + 添加按鈕。將打開一個彈出窗口，詢問是否添加 API 密鑰或請求來源。選擇請求來源并輸入您將從中發出請求的網站的域名。如果您的網站是 https://www.example.com，您應該在彈出窗口中輸入 example.com 作為您的請求來源。

保存成功后，您可以從主域以及主網站的所有子域發出請求。

Q：JSON 和 XML 響應格式？
A：ipgeolocation API的所有端點都可以以JSON和XML格式響應，JSON是默認響應格式。

Q：速率限制？

A：我們的免費計劃每天的請求數量硬性限制為 1000。但是，我們的任何付費計劃都沒有每日、每小時或每月的費率限制。如果您的月度配額增加，我們將繼續處理您的請求，并在您的月度價格之上增加附加費。附加費率因計劃而異。請參閱我們的定價頁面，了解每個計劃的附加費率。

Q：ipgeolocation API開放平臺的替代品有哪些？

除了ipgeolocation API開放平臺，還有其他替代服務商也提供類似api服務，例如：

vodgc API開放平臺、twinpush API開放平臺、優酷視頻云 API開放平臺

更多競品可以在冪簡集成開放平臺中找到。

Q：ipgeolocation API開放平臺這個密鑰還適用于哪些api？

單一 IP 地理位置查詢 API、用戶代理API、IP 到城市、ISP 和代理數據庫

5. 錯誤代碼

400 錯誤請求請求主體中缺少某些必填字段或字段值無效。

401 未授權必需的“apiKey”字段值缺失或無效。

403 禁止訪問受限。請檢查信用余額或輸入正確的 API 密鑰。

422 無法處理的實體輸入正確的請求參數或搜索詞。

429 請求過多請求過多。請稍后重試。

5XX內部服務器錯誤，請聯系我們的支持團隊。

6.? 總結

作為連接開發者與地理位置服務的橋梁，ipgeolocation API key 的獲取過程雖然并不復雜，但仍需要開發者嚴格遵循相關規范和步驟。首先，開發者需要在官方平臺完成注冊和身份認證，這一步驟是確保API使用安全性的重要保障。獲取到 API key 后，建議開發者立即進行功能測試，驗證API的響應速度、準確性和穩定性，這些都是確保服務質量的關鍵因素。同時，開發者還需要注意API的使用配額和訪問頻率限制，合理規劃資源使用，確保服務的持續可用性。通過這些細致的準備和規范的操作，開發者就能夠充分利用這一強大的地理位置服務，為其應用增添更多智能化的特性和功能。