README

一个纯 PHP 实现的中国坐标系转换库，无任何依赖，支持 PHP 5.6+。

项目支持

2233466866@qq.com

支持的坐标系

• WGS-84: GPS/国际通用坐标系
• GCJ-02: 国家测绘局坐标系（火星坐标）
• BD-09: 百度坐标系
• CGCS2000: 中国大地坐标系2000

快速开始

使用 Coordinate 类

<?php

use ChinaCoordinate\Coordinate;

// 创建坐标对象
$coord = new Coordinate(39.908056, 116.397778, Coordinate::SYSTEM_WGS84);

// 转换到其他坐标系
$gcj02 = $coord->transform(Coordinate::SYSTEM_GCJ02);
$bd09 = $coord->transform(Coordinate::SYSTEM_BD09);

echo $coord; // 39.908056,116.397778 (wgs84)
echo $gcj02; // 39.915,116.404 (gcj02)
echo $bd09;  // 39.921,116.411 (bd09)

使用 Transform 静态方法

<?php

use ChinaCoordinate\Transform;

// 单点转换
$result = Transform::wgs84ToBd09(39.908056, 116.397778);
// ['lat' => 39.921, 'lng' => 116.411]

// 批量转换
$points = [
    [39.908056, 116.397778],
    [31.2304, 121.4737],
];
$results = Transform::batchConvert($points, 'wgs84', 'bd09');

// 检查是否在中国
$isInChina = Transform::isInChina(39.908056, 116.397778); // true

// 计算距离
$distance = Transform::distance(39.908056, 116.397778, 31.2304, 121.4737);
// 北京到上海距离（米）

高级用法

自定义验证

<?php

$coord = new Coordinate(39.908056, 116.397778, 'wgs84');

// 获取数组格式
$array = $coord->toArray();
// ['latitude' => 39.908056, 'longitude' => 116.397778, 'system' => 'wgs84']

// 获取 JSON 格式
$json = $coord->toJson();

// 获取支持的坐标系
$systems = Coordinate::getSupportedSystems();

异常处理

<?php

use ChinaCoordinate\Exception\InvalidCoordinateException;

try {
    $coord = new Coordinate(100, 200, 'wgs84'); // 无效坐标
} catch (InvalidCoordinateException $e) {
    echo $e->getMessage(); // Latitude must be between -90 and 90 degrees
}

try {
    $coord = new Coordinate(39.908056, 116.397778, 'invalid_system');
} catch (\InvalidArgumentException $e) {
    echo $e->getMessage(); // Invalid coordinate system...
}