POST已開放coordinate-convert

經緯度解析+座標轉換

提供經緯度解析+座標轉換API服務，便於開發者快速解析經緯度座標相關資訊並整合至業務系統。

接入文件

經緯度解析+座標轉換API說明

經緯度解析+座標轉換API用於協助開發者在系統中快速完成經緯度解析+座標轉換相關處理，返回結構化結果，適合業務整合、自動化呼叫與系統對接等場景。

適用場景

支援將經緯度解析+座標轉換能力接入內部系統、SaaS 平台、自動化工作流程或營運後台。
適合需要穩定呼叫、標準化返回和可編排API能力的業務場景。
建議結合請求頻率控制、失敗重試和結果快取策略，提升整體接入穩定性。

接入建議

接入前確認請求參數格式、驗證方式和錯誤碼處理邏輯。
對高頻解析場景建議做好日誌追蹤、逾時控制和冪等處理。
若結果用於風控或自動決策，建議結合業務規則進行二次判斷，而非直接單點依賴API返回。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "lng": 116.397428,
  "lat": 39.90923,
  "from": "wgs84",
  "to": "gcj02"
}

響應示例

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "lng": 116.403694,
    "lat": 39.91487
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
lng	number	116.397428
lat	number	39.90923
from	string	wgs84
to	string	gcj02

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
code	string	SUCCESS
message	string	success
data	object	{...}
data.lng	number	116.403694
data.lat	number	39.91487

curl --request POST \ --url 'https://openapi.toolkk.com/v1/coordinate-convert' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "lng": 116.397428,\n "lat": 39.90923,\n "from": "wgs84",\n "to": "gcj02"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/coordinate-convert" payload = { "lng": 116.397428, "lat": 39.90923, "from": "wgs84", "to": "gcj02" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/coordinate-convert" payload := []byte("{\n \"lng\": 116.397428,\n \"lat\": 39.90923,\n \"from\": \"wgs84\",\n \"to\": \"gcj02\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"lng\": 116.397428,\n \"lat\": 39.90923,\n \"from\": \"wgs84\",\n \"to\": \"gcj02\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/coordinate-convert")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/coordinate-convert'; $payload = "{\n \"lng\": 116.397428,\n \"lat\": 39.90923,\n \"from\": \"wgs84\",\n \"to\": \"gcj02\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

經緯度解析+座標轉換

接入文件