geocoding.zuola.com

台灣座標查村

Health

把 GPS 打點變成可用的台灣行政區資料

適合外送派單、到府服務、物流簽收、田野調查、災情通報與巡檢紀錄。輸入經緯度，就能取得縣市、鄉鎮市區、村里名稱與官方代碼。

派單與配送

座標歸戶到村里

表單與通報

自動帶入行政區

資料分析

用代碼穩定彙整

使用方式

GET /api/reverse?lat=24.9884079&lng=121.4598882

API 入參使用 lat、lng。內部幾何計算固定使用 lng, lat 座標順序。

免費用户每小時 15 次請求。如需無限額或客制化 API，請聯絡佐拉。

回應範例

{
  "ok": true,
  "query": {
    "lat": 24.9884079,
    "lng": 121.4598882
  },
  "result": {
    "villcode": "65000130032",
    "county_name": "新北市",
    "town_name": "土城區",
    "village_name": "青雲里",
    "village_eng": "Qingyun Vil.",
    "county_id": "F",
    "county_code": "65000",
    "town_id": "F19",
    "town_code": "65000130"
  },
  "source": {
    "version": "1150511"
  }
}

Location Preview

目前位置行政區域

正在讀取 IP 推估位置...

若授權瀏覽器定位，台灣境內座標會查詢縣市、鄉鎮市區與村里。

當前所在行政區：讀取中

API Examples

主流程式呼叫範例

https://geocoding.zuola.com/api/reverse

<?php
$lat = 24.9884079;
$lng = 121.4598882;
$url = "https://geocoding.zuola.com/api/reverse?lat={$lat}&lng={$lng}";

$json = file_get_contents($url);
$data = json_decode($json, true);

if ($data["ok"]) {
    echo $data["result"]["county_name"] . PHP_EOL;
    echo $data["result"]["town_name"] . PHP_EOL;
    echo $data["result"]["village_name"] . PHP_EOL;
}

const lat = 24.9884079;
const lng = 121.4598882;
const url = new URL("https://geocoding.zuola.com/api/reverse");
url.search = new URLSearchParams({ lat, lng });

const response = await fetch(url);
const data = await response.json();

if (data.ok) {
  console.log(data.result.county_name);
  console.log(data.result.town_name);
  console.log(data.result.village_name);
}

using System.Net.Http.Json;
using System.Text.Json.Serialization;

using var client = new HttpClient();
var lat = 24.9884079;
var lng = 121.4598882;
var url = $"https://geocoding.zuola.com/api/reverse?lat={lat}&lng={lng}";

var data = await client.GetFromJsonAsync<ReverseResponse>(url);

if (data?.Ok == true) {
    Console.WriteLine(data.Result.CountyName);
    Console.WriteLine(data.Result.TownName);
    Console.WriteLine(data.Result.VillageName);
}

public record ReverseResponse(
    [property: JsonPropertyName("ok")] bool Ok,
    [property: JsonPropertyName("result")] Village Result
);

public record Village(
    [property: JsonPropertyName("county_name")] string CountyName,
    [property: JsonPropertyName("town_name")] string TownName,
    [property: JsonPropertyName("village_name")] string VillageName
);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var lat = 24.9884079;
var lng = 121.4598882;
var url = "https://geocoding.zuola.com/api/reverse?lat=" + lat + "&lng=" + lng;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder(URI.create(url)).GET().build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	url := "https://geocoding.zuola.com/api/reverse?lat=24.9884079&lng=121.4598882"
	resp, err := http.Get(url)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]any
	if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
		panic(err)
	}

	fmt.Println(data)
}

use serde::Deserialize;

#[derive(Debug, Deserialize)]
struct ReverseResponse {
    ok: bool,
    result: Option<Village>,
}

#[derive(Debug, Deserialize)]
struct Village {
    county_name: String,
    town_name: String,
    village_name: String,
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let url = "https://geocoding.zuola.com/api/reverse?lat=24.9884079&lng=121.4598882";
    let data: ReverseResponse = reqwest::get(url).await?.json().await?;

    if let Some(result) = data.result {
        println!("{} {} {}", result.county_name, result.town_name, result.village_name);
    }

    Ok(())
}

curl 'https://geocoding.zuola.com/api/reverse?lat=24.9884079&lng=121.4598882'