jundayw/location-based-services

The PHP library for LBS transform coordinates

v3.0.0 2023-03-17 17:39 UTC

This package is auto-updated.

Last update: 2024-10-17 21:01:00 UTC


README

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

地心坐标系及椭球常识

安装方法

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

composer require jundayw/location-based-services

Latest Stable Version Total Downloads Latest Unstable Version License PHP Version Require

方法集合

  • 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,    // 百度坐标系距离
];