鍵.png)
使用這些基本 REST API 最佳實踐構(gòu)建出色的 API
1. 登錄以后進(jìn)入我的應(yīng)用,點擊創(chuàng)建應(yīng)用
2.在彈窗里填入應(yīng)用名稱然后點擊提交
3.創(chuàng)建成功后點擊復(fù)制應(yīng)用token
調(diào)用方式
使用 API 前,需要先注冊賬號并完成用戶認(rèn)證
服務(wù)地址 | https://api.open.geovisearth.com/v2/cn/area/basic |
---|---|
請求方式 | GET 方法 |
接口鑒權(quán) | 服務(wù)密鑰授權(quán),您需要 申請 token,將 token 作為必填參數(shù)拼接在服務(wù)地址中一起請求 |
調(diào)用限制 | 服務(wù)調(diào)用量的限制請點擊 這里 查閱 |
請求參數(shù)
參數(shù)名 | 含義 | 規(guī)則數(shù)據(jù) | 是否必填 | 缺省值 |
location | 如果按市區(qū)縣代碼查詢,則為市區(qū)縣代碼 | string | 是 | / |
如果按經(jīng)緯度查詢,則為經(jīng)緯度數(shù)據(jù),經(jīng)度和緯度用英文逗號分隔 | double[] |
返回參數(shù)
參數(shù)名 | 類型 | 說明 |
status | int | 狀態(tài)碼,非0表示沒有正常獲取到數(shù)據(jù) |
time | String | 請求時間,格式:yyyyMMddHHmmss |
timeZone | String | 查詢地點時區(qū) |
areaCode | String | 市區(qū)縣代碼信息,傳入經(jīng)緯度時無該字段返回 |
path | String | 行政區(qū)劃路徑,省、市、區(qū)縣名稱,以英文逗號分隔,傳入經(jīng)緯度時無該字段返回 |
wp_code | String | 天氣現(xiàn)象編碼 |
wp | String | 天氣現(xiàn)象 |
tem | double | 溫度,單位:℃ |
rh | int | 相對濕度,單位:% |
wd_desc | String | 風(fēng)向描述 |
ws_desc | String | 風(fēng)力 |
prs | double | 地面氣壓,單位:hPa |
調(diào)用示例
請求示例
https://api.open.geovisearth.com/v2/cn/area/basic?token=您的token&location=WTX_CH101300201
返回示例
{
"date": {
"timeZone": "Asia/Shanghai",
"time": "20240911135031"
},
"result": {
"wd_desc": "東北風(fēng)",
"prs": 986.7,
"rh": 95,
"ws_desc": "3級",
"wp": "陰",
"tem": 26.7,
"wp_code": "02"
},
"location": {
"path": "廣西壯族自治區(qū),崇左市,崇左",
"areaCode": "WTX_CH101300201"
},
"version": "v1",
"status": 0
}
Q:如何找到數(shù)字地球開放平臺
A:冪簡集成是國內(nèi)領(lǐng)先的API集成管理平臺,專注于為開發(fā)者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關(guān)鍵詞搜索API(例如,輸入’數(shù)字地球開放平臺‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁進(jìn)入尋找。
Q:如何查看接口包含哪些要素?
A:在頁面中點擊接口名稱,即可查看對應(yīng)接口的詳細(xì)開發(fā)文檔,內(nèi)容涵蓋了API接口介紹、要素列表、請求參數(shù)說明、返回數(shù)據(jù)格式、示例等多個方面,可幫助開發(fā)者快速調(diào)用。
Q:是否支持單一接口的調(diào)用?
A:目前僅有部分接口支持按要素或按調(diào)用量進(jìn)行購買,若當(dāng)前套餐與您的需求不符,可隨時聯(lián)系在線客服咨詢單接口調(diào)用服務(wù)。
Q:如果已經(jīng)購買了套餐,是否支持更換套餐?
A:支持套餐變更,若您在使用過程中需要調(diào)整套餐,可聯(lián)系客服根據(jù)套餐變更的具體情況,進(jìn)行相應(yīng)的費用調(diào)整。
Q:出現(xiàn) 405 不允許跨域請求 時怎么辦?
A:可以追加GET參數(shù) &yesapi_allow_origin=1
,或參考用反向代理解決跨域問題等3種解決方案。
除了數(shù)字地球開放平臺,還有其他替代服務(wù)商也提供類似api服務(wù),例如:
高德地圖開放平臺、我秀中國 API開放平臺、百度地圖開放平臺
更多競品可以在冪簡集成開放平臺中找到。
Q:數(shù)字地球開放平臺這個密鑰還適用于哪些api?
全國天氣實況-基礎(chǔ)版、全國城市45天逐日預(yù)報、全球衛(wèi)星可視化圖層
本文全面而細(xì)致地介紹了獲取數(shù)字地球開放平臺密鑰的完整流程,為開發(fā)者們提供了一份條理清晰、易于操作的實用指南。從數(shù)字地球開放平臺的賬號注冊開始,到完成開發(fā)者身份驗證,再到最終成功獲取API密鑰,每一步操作都配以詳盡的說明與指導(dǎo),確保開發(fā)者能夠輕松、準(zhǔn)確地完成整個流程。獲取密鑰只是利用數(shù)字地球開放平臺的第一步,如何高效、穩(wěn)定地集成并應(yīng)用其提供的豐富地理空間數(shù)據(jù)才是關(guān)鍵。因此,本文特別強(qiáng)調(diào)了獲取密鑰后應(yīng)進(jìn)行可用性測試的重要性,這不僅有助于開發(fā)者了解API的性能和穩(wěn)定性,還能確保API能夠順利集成到應(yīng)用中并發(fā)揮最佳效果。本文為開發(fā)者們提供了一個全面、詳盡且極具實用價值的操作指南,幫助他們順利獲取數(shù)字地球開放平臺的密鑰,并將這一強(qiáng)大的地理空間數(shù)據(jù)處理能力有效地集成到應(yīng)用中。我們堅信,隨著開發(fā)者們對這一指南的深入理解和實踐,將能夠充分利用數(shù)字地球開放平臺的優(yōu)勢,為應(yīng)用的智能化、高效化發(fā)展注入新的活力,進(jìn)而提升應(yīng)用的性能和用戶體驗。