PHPackages jundayw/location-based-services - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. jundayw/location-based-services ActiveLibrary[Utility & Helpers](/categories/utility) jundayw/location-based-services =============================== The PHP library for LBS transform coordinates v3.0.0(3y ago)12.2kMITPHPPHP >=7.2 Since Apr 27Pushed 1y ago1 watchersCompare [ Source](https://github.com/jundayw/location-based-services)[ Packagist](https://packagist.org/packages/jundayw/location-based-services)[ RSS](/packages/jundayw-location-based-services/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (4)Used By (0) 基于椭球体坐标及坐标系转换和计算服务（Location Based Services，LBS） ----------------------------------------------- [](#基于椭球体坐标及坐标系转换和计算服务location-based-serviceslbs) - 可扩展任意椭球体计算：需实现 Circle 接口； - 可扩展任意椭球体坐标系转换：需继承 Geography 抽象类； - 可扩展任意椭球体计算方法：默认只支持两坐标距离计算，可扩展实现三角形、正方形、长方形、梯形面积计算； - 可扩展计算单位：默认支持长度单位，可扩展面积单位，需实现 Units 接口； - 可扩展任意地理坐标系：北京 54、西安 80、 WGS84、GCJ-02、BD-09、GCS2000 - 可扩展任意语言：默认支持中文英文，可自定义其他语言； [地心坐标系及椭球常识](documentor.md) --------------------------- [](#地心坐标系及椭球常识) 安装方法 ==== [](#安装方法) 命令行下, 执行 composer 命令安装: ``` composer require jundayw/location-based-services ``` [![Latest Stable Version](https://camo.githubusercontent.com/31cc15a62bb1afa1f39c523f28d2c8b19d1ac17b73cb191ca13fe1de33214559/68747470733a2f2f706f7365722e707567782e6f72672f6a756e646179772f6c6f636174696f6e2d62617365642d73657276696365732f76)](https://packagist.org/packages/jundayw/location-based-services)[![Total Downloads](https://camo.githubusercontent.com/d8d8e74edf494013062d786c8fbe600d15d743131f1399ecf1b71bc873601022/68747470733a2f2f706f7365722e707567782e6f72672f6a756e646179772f6c6f636174696f6e2d62617365642d73657276696365732f646f776e6c6f616473)](https://packagist.org/packages/jundayw/location-based-services)[![Latest Unstable Version](https://camo.githubusercontent.com/7650c41b76e05e95181a8d79c87ecf8566e96fa11b96150b9489b80fbc2d0079/68747470733a2f2f706f7365722e707567782e6f72672f6a756e646179772f6c6f636174696f6e2d62617365642d73657276696365732f762f756e737461626c65)](https://packagist.org/packages/jundayw/location-based-services)[![License](https://camo.githubusercontent.com/5ecfa208efecf143f57a8baa8a96666b83046649ddf04d7429ce1fc0a07a199e/68747470733a2f2f706f7365722e707567782e6f72672f6a756e646179772f6c6f636174696f6e2d62617365642d73657276696365732f6c6963656e7365)](https://packagist.org/packages/jundayw/location-based-services)[![PHP Version Require](https://camo.githubusercontent.com/2b55fef86638db6994d51903edb77583b79da13639ccd484c45f2c9d0813e211/68747470733a2f2f706f7365722e707567782e6f72672f6a756e646179772f6c6f636174696f6e2d62617365642d73657276696365732f726571756972652f706870)](https://packagist.org/packages/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。 ### 中文标签 [](#中文标签-1) ``` $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秒', ) ``` ### 英文标签 [](#英文标签-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 坐标系转百度坐标系计算距离 ----------------- [](#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 坐标系转百度坐标系计算距离 ----------------- [](#gps-坐标系转百度坐标系计算距离-1) ``` $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, // 百度坐标系距离 ]; ``` ### Health Score 28 — LowBetter than 54% of packages Maintenance31 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community7 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~162 days Total 3 Last Release 1158d ago Major Versions v1.0.0 → v2.0.02023-03-17 v2.0.0 → v3.0.02023-03-17 ### Community Maintainers ![](https://www.gravatar.com/avatar/2da9b458375a1b7972b7c4d26a5bf8f3e48db305e8805da36f253956f33c5568?d=identicon)[jundayw](/maintainers/jundayw) --- Top Contributors [![jundayw](https://avatars.githubusercontent.com/u/16873970?v=4)](https://github.com/jundayw "jundayw (14 commits)") --- Tags baidumapbd-09gaodemapgcj-02google-mapslbsmapwgs84 ### Embed Badge ![Health badge](/badges/jundayw-location-based-services/health.svg) ``` [![Health](https://phpackages.com/badges/jundayw-location-based-services/health.svg)](https://phpackages.com/packages/jundayw-location-based-services) ``` ### Alternatives [rinvex/countries Rinvex Countries is a simple and lightweight package for retrieving country details with flexibility. A whole bunch of data including name, demonym, capital, iso codes, dialling codes, geo data, currencies, flags, emoji, and other attributes for all 250 countries worldwide at your fingertips. 1.7k7.4M48](/packages/rinvex-countries)[tecnickcom/tc-lib-color PHP library to manipulate various color representations 247.2M9](/packages/tecnickcom-tc-lib-color)[pinkary-project/type-guard Type Guard module is part of the Pinkary Project, and allows you to \*\*narrow down the type\*\* of a variable to a more specific type. 198102.4k14](/packages/pinkary-project-type-guard)[lingaro/magento2-codegen Magento 2 Code Generator 966.5k](/packages/lingaro-magento2-codegen) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)