API Documentation

Programmatic access to all coordinate conversions via REST API.

POST/api/convert

Convert a single coordinate pair

Request Body

{"lng":116.397428,"lat":39.909204,"from":"WGS84","to":"GCJ02"}

Response

{
  "success": true,
  "data": {
    "lng": 116.403954,
    "lat": 39.910715,
    "isInChina": true
  }
}

curl Example

curl -X POST https://www.geocoordconv.cc.cd/api/convert -H "Content-Type: application/json" -d '{"lng":116.397428,"lat":39.909204,"from":"WGS84","to":"GCJ02"}'
POST/api/batch

Batch convert up to 1000 points

Request Body

{"points":[{"lng":116.39,"lat":39.90}],"from":"WGS84","to":"GCJ02"}

Response

{
  "success": true,
  "data": {
    "lng": 116.403954,
    "lat": 39.910715,
    "isInChina": true
  }
}

curl Example

curl -X POST https://www.geocoordconv.cc.cd/api/batch -H "Content-Type: application/json" -d '{"points":[{"lng":116.39,"lat":39.90}],"from":"WGS84","to":"GCJ02"}'

Rate Limits

  • Single convert: 100 requests per minute per IP
  • Batch convert: 10 requests per minute per IP (max 1000 points per request)