Fast Free & Open API for
Cambodia Geography

// 1. Cascading lookup: Fetch all districts in Phnom Penh (Province Code: 12)
const res = await fetch('https://opengeo-cambodia.pphat.me/api/admin/provinces/12/districts');
const { data: districts } = await res.json();
console.log('Districts found:', districts.map(d => `${d.code} - ${d.name_km} (${d.name_en})`));

// 2. Reverse geocode GPS coordinates to 4-tier Cambodian address
const geoRes = await fetch('https://opengeo-cambodia.pphat.me/api/geocode/reverse?lat=11.5564&lon=104.9282');
const location = await geoRes.json();
console.log(`${location.province} > ${location.district} > ${location.commune}`);

// 3. Fast bilingual search (Khmer script & Latin romanization)
const searchRes = await fetch('https://opengeo-cambodia.pphat.me/api/admin/search?q=' + encodeURIComponent('វត្តភ្នំ'));
const searchData = await searchRes.json();
console.log('Search matches:', searchData.data);

import requests

BASE_URL = "https://opengeo-cambodia.pphat.me"

# 1. Fuzzy search for administrative entities (Khmer or English)
response = requests.get(f"{BASE_URL}/api/admin/search", params={"q": "Doun Penh"})
matches = response.json()
print(f"Found {len(matches.get('data', []))} administrative records")

# 2. Complete 4-tier hierarchy trace for Sangkat Phsar Thmei 1 (code 120101)
hierarchy = requests.get(f"{BASE_URL}/api/admin/hierarchy/120101").json()
print("Administrative Path:", hierarchy.get("path"))

# 3. GPS Reverse Geocoding (Wat Phnom: 11.5761, 104.9230)
geo = requests.get(f"{BASE_URL}/api/geocode/reverse", params={"lat": 11.5761, "lon": 104.9230}).json()
print(f"Address: {geo.get('commune')}, {geo.get('district')}, {geo.get('province')}")

# 1. Fetch all 25 Provinces in Cambodia (<1ms edge response)
curl -s "https://opengeo-cambodia.pphat.me/api/admin/provinces" \
  | jq '.data[] | {code, name_km, name_en}'

# 2. Reverse geocode GPS coordinates (Independence Monument, Phnom Penh)
curl -s "https://opengeo-cambodia.pphat.me/api/geocode/reverse?lat=11.5564&lon=104.9282" \
  | jq '{province: .province, district: .district, commune: .commune}'

# 3. Bilingual administrative search in Khmer script
curl -s -G "https://opengeo-cambodia.pphat.me/api/admin/search" \
  --data-urlencode "q=សៀមរាប" | jq '.data[0]'

<?php
// 1. Fetch all districts of Siem Reap province (Province Code: 17)
$url = 'https://opengeo-cambodia.pphat.me/api/admin/provinces/17/districts';
$response = file_get_contents($url);
$districts = json_decode($response, true)['data'] ?? [];

foreach ($districts as $district) {
    echo "{$district['code']}: {$district['name_km']} ({$district['name_en']})\n";
}

// 2. Reverse geocode GPS coordinates to Cambodian Address
$geoUrl = 'https://opengeo-cambodia.pphat.me/api/geocode/reverse?lat=11.5564&lon=104.9282';
$geo = json_decode(file_get_contents($geoUrl), true);
echo "Location: {$geo['commune']}, {$geo['district']}, {$geo['province']}\n";

package main

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

type ApiResponse struct {
    Success bool             `json:"success"`
    Data    []map[string]any `json:"data"`
}

func main() {
    // 1. Fetch Cambodia 25 Provinces (<1ms in-memory cache)
    resp, err := http.Get("https://opengeo-cambodia.pphat.me/api/admin/provinces")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result ApiResponse
    if err := json.NewDecoder(resp.Body).Decode(&result); err == nil {
        fmt.Printf("Loaded %d provinces successfully\n", len(result.Data))
    }
}

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> main() async {
  const baseUrl = 'https://opengeo-cambodia.pphat.me';

  // 1. Fetch Cambodia 25 Provinces for mobile address dropdown
  final res = await http.get(Uri.parse('$baseUrl/api/admin/provinces'));
  if (res.statusCode == 200) {
    final Map<String, dynamic> body = jsonDecode(res.body);
    final List provinces = body['data'];
    print('Loaded ${provinces.length} provinces successfully');
  }

  // 2. Reverse Geocode GPS coordinates (Phnom Penh)
  final geoRes = await http.get(Uri.parse(
    '$baseUrl/api/geocode/reverse?lat=11.5564&lon=104.9282'
  ));
  final location = jsonDecode(geoRes.body);
  print('Address: ${location['province']} > ${location['district']} > ${location['commune']}');
}

import okhttp3.OkHttpClient
import okhttp3.Request
import org.json.JSONObject

val client = OkHttpClient()
val baseUrl = "https://opengeo-cambodia.pphat.me"

// 1. Cascading lookup: Phnom Penh districts (Code: 12)
val request = Request.Builder()
    .url("$baseUrl/api/admin/provinces/12/districts")
    .build()

client.newCall(request).execute().use { response ->
    val json = JSONObject(response.body!!.string())
    val districts = json.getJSONArray("data")
    println("Found ${districts.length()} districts in Phnom Penh")
}

// 2. Reverse Geocode GPS coordinates (Wat Phnom: 11.5761, 104.9230)
val geoRequest = Request.Builder()
    .url("$baseUrl/api/geocode/reverse?lat=11.5761&lon=104.9230")
    .build()
val geo = JSONObject(client.newCall(geoRequest).execute().body!!.string())
println("Location: ${geo.optString("commune")}, ${geo.optString("district")}, ${geo.optString("province")}")

using System;
using System.Net.Http;
using System.Text.Json;
using System.Threading.Tasks;

using var client = new HttpClient();
const string baseUrl = "https://opengeo-cambodia.pphat.me";

// 1. Fetch all 25 Provinces in Cambodia (<1ms response)
var json = await client.GetStringAsync($"{baseUrl}/api/admin/provinces");
using var doc = JsonDocument.Parse(json);
var provinces = doc.RootElement.GetProperty("data");

foreach (var p in provinces.EnumerateArray())
{
    Console.WriteLine($"{p.GetProperty("code")}: {p.GetProperty("name_km")} ({p.GetProperty("name_en")})");
}

// 2. Reverse Geocode GPS to Cambodian Address
var geoJson = await client.GetStringAsync($"{baseUrl}/api/geocode/reverse?lat=11.5564&lon=104.9282");
using var geoDoc = JsonDocument.Parse(geoJson);
Console.WriteLine($"Province: {geoDoc.RootElement.GetProperty("province")}");

import Foundation

let baseUrl = "https://opengeo-cambodia.pphat.me"

// 1. Fetch 25 Cambodia Provinces asynchronously
guard let url = URL(string: "\(baseUrl)/api/admin/provinces") else { return }
let (data, _) = try await URLSession.shared.data(from: url)

if let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
   let provinces = json["data"] as? [[String: Any]] {
    print("Loaded \(provinces.count) Cambodian provinces")
}

// 2. Reverse Geocode GPS coordinates (CoreLocation integration)
let geoUrl = URL(string: "\(baseUrl)/api/geocode/reverse?lat=11.5564&lon=104.9282")!
let (geoData, _) = try await URLSession.shared.data(from: geoUrl)
if let loc = try? JSONSerialization.jsonObject(with: geoData) as? [String: Any] {
    print("\(loc["province"] ?? "") > \(loc["district"] ?? "")")
}

use reqwest;
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let base_url = "https://opengeo-cambodia.pphat.me";

    // 1. Fetch all 25 Provinces (<1ms edge response)
    let resp: Value = reqwest::get(format!("{}/api/admin/provinces", base_url))
        .await?
        .json()
        .await?;

    if let Some(provinces) = resp["data"].as_array() {
        println!("Loaded {} provinces successfully", provinces.len());
    }

    // 2. Reverse Geocode Coordinates
    let geo: Value = reqwest::get(format!("{}/api/geocode/reverse?lat=11.5564&lon=104.9282", base_url))
        .await?
        .json()
        .await?;

    println!("Location: {} / {}", geo["district"], geo["province"]);
    Ok(())
}