包简介

The PHP library for LBS transform coordinates

README 文档

README

可扩展任意椭球体计算：需实现 Circle 接口；
可扩展任意椭球体坐标系转换：需继承 Geography 抽象类；
可扩展任意椭球体计算方法：默认只支持两坐标距离计算，可扩展实现三角形、正方形、长方形、梯形面积计算；
可扩展计算单位：默认支持长度单位，可扩展面积单位，需实现 Units 接口；
可扩展任意地理坐标系：北京 54、西安 80、 WGS84、GCJ-02、BD-09、GCS2000
可扩展任意语言：默认支持中文英文，可自定义其他语言；

地心坐标系及椭球常识

安装方法

命令行下, 执行 composer 命令安装:

composer require jundayw/location-based-services

方法集合

AbstractPoint
- format(string $format = "d°m′s″L", bool $flip = false, int $decimals = 2): array
- parse(int $decimals = 2, bool $flip = false): array
- getLng(): float
- setLng(float $lng)
- getLat(): float
- setLat(float $lat)
Point extends AbstractPoint
Converter extends Point
- setLng($lng)
- setLat($lat)
Position
- getDistance(AbstractPoint $start, AbstractPoint $end): float
- getDistanceUnit(AbstractPoint $start, AbstractPoint $end): string
- getCircle(): Circle
- setCircle(Circle $circle): Position
- getUnits(): Units
- setUnits(Units $units): Position
- getDecimals(): int
- setDecimals(int $decimals): Position
Translate
- translate(AbstractPoint $point): AbstractPoint
- getInput(): string
- setInput(string $input): Translate
- getOutput(): string
- setOutput(string $output): Translate
- getRoutes(): array
- setRoutes(array $routes): Translate

坐标计算

├─Position.php              // 通过坐标计算距离
├─Circles
│      Circle.php           // 接口
│      Earth.php            // 地球相关参数
├─Point
│      AbstractPoint.php    // 将标准坐标格式转换为不同坐标格式
│      Point.php            // 标准坐标格式
├─Converters
│      Converter.php        // 将不同坐标格式转换为标准坐标格式
└─Units
        LengthUnit.php      // 长度单位换算
        Units.php           // 接口

支持坐标格式

// 标准坐标格式
$points    = [
    [116.4028930664, 39.9034155951],
    [-114.3347167969, -30.5433389542],
];
// 其他支持的坐标格式
$points    = [
    ["东经98度2分43秒", "南纬24度45分16.1秒"],
    ["98°2′43.8″E", "24°45′16.1″S"],
    ["E98°2′43.8″", "S24°45′16.1″"],
    ["98°59′59.9″E", "24°59′59.9″N"],
    ["98°59′59.9″W", "24°59′59.9″S"],
    ["98.5°E", "24.5°S"],
    ["98.5E", "24.5S"],
    [98.5, -24.5],
];

计算两坐标间距离

$position = new Position();
$position->setDecimals(2);
// 标准坐标计算距离
$distance = $position->getDistance(
    new Point(116.4028930664, 39.9034155951),
    new Point(114.3347167969, 30.5433389542)
);
// 结果：1058703.49
// 其他格式标准计算距离
$distance = $position->getDistance(
    new Converter("东经98度58分45.8秒", "南纬24度45分16.1秒"),
    new Converter("116°23′28.4″E", "39°54′26.2″N")
);
// 结果：7421559.99

计算两坐标间距离（附加单位）

$position = new Position(new LengthUnit("KM"));
$position->setDecimals(2);
// 标准坐标计算距离
$distance = $position->getDistanceUnit(
    new Point(116.4028930664, 39.9034155951),
    new Point(114.3347167969, 30.5433389542)
);
// 结果：1058.7KM
// 其他格式标准计算距离
$distance = $position->getDistanceUnit(
    new Converter("东经98度58分45.8秒", "南纬24度45分16.1秒"),
    new Converter("116°23′28.4″E", "39°54′26.2″N")
);
// 结果：7421.56KM

坐标解析

英文标签

$point = new Point(98.979388888889, -24.754472222222);
$point = new Converter("东经98度58分45.8秒", "南纬24度45分16.1秒");
var_dump($point->parse());

输出结果：

array (
  'longitude' => array (
        'DDD' => 98.979388888889,
        'ddd' => 98.979388888889,
        'D' => 98,
        'd' => 98,
        'm' => 58,
        's' => 45.8,
        'L' => 'E',
  ),
  'latitude' => array (
        'DDD' => -24.754472222222,
        'ddd' => 24.754472222222,
        'D' => -24,
        'd' => 24,
        'm' => 45,
        's' => 16.1,
        'L' => 'S',
  ),
)

中文标签

$point = new Point(98.979388888889, -24.754472222222);
$point = new Converter("东经98度58分45.8秒", "南纬24度45分16.1秒");
var_dump($point->parse(2, true));

输出结果：

array (
  'longitude' => array (
        'DDD' => 98.979388888889,
        'ddd' => 98.979388888889,
        'D' => 98,
        'd' => 98,
        'm' => 58,
        's' => 45.8,
        'L' => '东经',
  ),
  'latitude' => array (
        'DDD' => -24.754472222222,
        'ddd' => 24.754472222222,
        'D' => -24,
        'd' => 24,
        'm' => 45,
        's' => 16.1,
        'L' => '南纬',
  ),
)

坐标格式转换

可根据具体需求转换需要的格式，支持标签：DDD、ddd、D、d、m、s、L。L中文情况下支持：东经、西经、北纬、南纬；英文情况下支持：E、W、N、S。

中文标签

$point = new Point(98.979388888889, -24.754472222222);
$point = new Converter("东经98度58分45.8秒", "南纬24度45分16.1秒");
var_export($point->format("Ld度m分s秒", true));

输出结果：

array (
  'longitude' => '东经98度58分45.8秒',
  'latitude' => '南纬24度45分16.1秒',
)

英文标签

$point = new Point(98.979388888889, -24.754472222222);
$point = new Converter("东经98度58分45.8秒", "南纬24度45分16.1秒");
var_export($point->format());

输出结果：

array (
  'longitude' => '98°58′45.8″E',
  'latitude' => '24°45′16.1″S',
)

坐标系转换

├─Translate.php             // 坐标系转换，如：GPS、火星坐标(Google/高德)、百度坐标系
└─Geographies
       BD09.php             // 百度坐标系编码、解码
       GCJ02.php            // 火星坐标系编码、解码
       Geography.php        // 坐标系基础配置
       WGS84.php            // GPS坐标系编码、解码

坐标系转换：标准坐标格式

$points = [
    [116.4028930664, 39.9034155951],
    [-114.3347167969, -30.5433389542],
];

foreach ($points as $point) {
    $point = new Point($point[0], $point[1]);
}
// WGS84(GPS坐标系)/GCJ02(火星坐标系)/BD09(百度坐标系)之间可以互相任意转换
$translate = new Translate(WGS84::class, GCJ02::class);// GPS坐标系转火星坐标系
$translate = new Translate(WGS84::class, BD09::class);// GPS坐标系转百度坐标系
$translate = new Translate(BD09::class, GCJ02::class);// 百度坐标系转火星坐标系
$translate = new Translate(BD09::class, WGS84::class);// 百度坐标系转GPS坐标系
$point     = $translate->translate($point);// 转换后坐标

坐标系转换：其他坐标格式

$points = [
    ["东经98度2分43秒", "南纬24度45分16.1秒"],
    ["98°2′43.8″E", "24°45′16.1″S"],
    ["E98°2′43.8″", "S24°45′16.1″"],
    ["98°59′59.9″E", "24°59′59.9″N"],
    ["98°59′59.9″W", "24°59′59.9″S"],
    ["98.5°E", "24.5°S"],
    ["98.5E", "24.5S"],
    ["98.5", "-24.5"],
    [116.4028930664, 39.9034155951],
    [-114.3347167969, -30.5433389542],
];

foreach ($points as $point) {
    $converter = new Converter($point[0], $point[1]);
}
// WGS84(GPS坐标系)/GCJ02(火星坐标系)/BD09(百度坐标系)之间可以互相任意转换
$translate = new Translate(WGS84::class, GCJ02::class);// GPS坐标系转火星坐标系
$translate = new Translate(WGS84::class, BD09::class);// GPS坐标系转百度坐标系
$translate = new Translate(BD09::class, GCJ02::class);// 百度坐标系转火星坐标系
$translate = new Translate(BD09::class, WGS84::class);// 百度坐标系转GPS坐标系
$point     = $translate->translate($converter);// 转换后坐标

不同坐标系间距离计算

GPS 坐标系转百度坐标系计算距离

$start     = new Point(106.0, 39.0);// GPS 坐标
$end       = new Point(107.0, 40.0);// GPS 坐标
$position  = new Position();
$gps       = $position->getDistance($start, $end);
$translate = new Translate(WGS84::class, BD09::class);
$bd09      = $position->getDistance($translate->translate($start), $translate->translate($end));

中国区域距离结果：

[
    "gps"  => 140604.6,     // GPS 坐标系距离
    "bd09" => 140673.57,    // 百度坐标系距离
];

GPS 坐标系转百度坐标系计算距离

$start     = new Point(1.0, 39.0);// GPS 坐标
$end       = new Point(1.0, 40.0);// GPS 坐标
$position  = new Position();
$gps       = $position->getDistance($start, $end);
$translate = new Translate(WGS84::class, BD09::class);
$bd09      = $position->getDistance($translate->translate($start), $translate->translate($end));

非中国区域距离结果：

[
    "gps"  => 111319.49,    // GPS 坐标系距离
    "bd09" => 111319.49,    // 百度坐标系距离
];

jundayw/location-based-services 适用场景与选型建议

jundayw/location-based-services 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 2.22k 次下载、GitHub Stars 达 1，最近一次更新时间为 2022 年 04 月 26 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 jundayw/location-based-services 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 jundayw/location-based-services 我们能提供哪些服务？

定制开发 / 二次开发

基于 jundayw/location-based-services 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

jundayw/location-based-services

包简介

README 文档

README

地心坐标系及椭球常识

安装方法

方法集合

坐标计算

支持坐标格式

计算两坐标间距离

计算两坐标间距离（附加单位）

坐标解析

英文标签

中文标签

坐标格式转换

中文标签

英文标签

坐标系转换

坐标系转换：标准坐标格式

坐标系转换：其他坐标格式

不同坐标系间距离计算

GPS 坐标系转百度坐标系计算距离

GPS 坐标系转百度坐标系计算距离

jundayw/location-based-services 适用场景与选型建议

统计信息

GitHub 信息

其他信息