README

PHP 几何库提供用于在地球表面计算几何数据的实用函数。代码移植自 Google Maps Android API。

功能

球面包含球面几何实用工具，允许您从纬度和经度计算角度、距离和面积。
多边形实用函数，用于涉及多边形和折线的计算。
编码实用工具，用于折线编码和解码。

依赖

PHP 5

安装

运行以下命令

composer require brianfp/geometry-library:1.0.2

或者编辑 composer.json，添加以下行并运行 composer update

"require": { 
		....,
		"brianfp/geometry-library":"1.0.2",
	
	},

用法

以下是如何使用 GeometryLibrary 的示例

$response =  \GeometryLibrary\SphericalUtil::computeHeading(
                ['lat' => 25.775, 'lng' => -80.190], // from array [lat, lng]
                ['lat' => 21.774, 'lng' => -80.190]); // to array [lat, lng]
  echo $response; // -180
  
$response = \GeometryLibrary\SphericalUtil::computeDistanceBetween(
              ['lat' => 25.775, 'lng' => -80.190], //from array [lat, lng]
              ['lat' => 21.774, 'lng' => -80.190]); // to array [lat, lng]
              
  echo $response; // 444891.52998049          
  
  
$response =  \GeometryLibrary\PolyUtil::isLocationOnEdge(
              ['lat' => 25.774, 'lng' => -80.190], // point array [lat, lng]
              [ // poligon arrays of [lat, lng]
                ['lat' => 25.774, 'lng' => -80.190], 
                ['lat' => 18.466, 'lng' => -66.118], 
                ['lat' => 32.321, 'lng' => -64.757]
              ])  ;
              
  echo $response; // true
  
  
  
$response =  \GeometryLibrary\PolyUtil::isLocationOnPath(
              ['lat' => 25.771, 'lng' => -80.190], // point array [lat, lng]
             [ // poligon arrays of [lat, lng]
              ['lat' => 25.774, 'lng' => -80.190], 
              ['lat' => 18.466, 'lng' => -66.118], 
              ['lat' => 32.321, 'lng' => -64.757]
             ]);  
             
  echo $response; // false  
  
$response =  \GeometryLibrary\PolyUtil::containsLocation(
              ['lat' => 23.886, 'lng' => -65.269], // point array [lat, lng]
             [ // poligon arrays of [lat, lng]
                ['lat' => 25.774, 'lng' => -80.190], 
                ['lat' => 18.466, 'lng' => -66.118], 
                ['lat' => 32.321, 'lng' => -64.757]
             ]);  
             
  echo $response; // false    
  
$response =  \GeometryLibrary\PolyUtil::distanceToLine(
              ['lat' => 61.387002, 'lng' => 23.890636], // point array [lat, lng]
              ['lat' => 61.487002, 'lng' => 23.790636], // line startpoint array [lat, lng]
              ['lat' => 60.48047, 'lng' => 22.052754] // line endpoint array [lat, lng]
             );  
             
  echo $response; // 12325.124046196 in meters
  
$response =  \GeometryLibrary\PolyUtil::encode(
              [ 
                ['lat' => 38.5, 'lng' => -120.2], 
                ['lat' => 40.7, 'lng' => -120.95], 
                ['lat' => 43.252, 'lng' => -126.453]
              ]);
              
  echo $response; // '_p~iF~ps|U_ulLnnqC_mqNvxq`@'
  
  
$response =  \GeometryLibrary\PolyUtil::decode('_p~iF~ps|U_ulLnnqC_mqNvxq`@');  

  echo $response; /** array (size=3)
                        0 => 
                          array (size=2)
                            'lat' => float 38.5
                            'lng' => float -120.2
                        1 => 
                          array (size=2)
                            'lat' => float 40.7
                            'lng' => float -120.95
                        2 => 
                          array (size=2)
                            'lat' => float 43.252
                            'lng' => float -126.453
                   */

可用方法

PolyUtil 类

containsLocation($point, $polygon, $geodesic = false)
isLocationOnEdge($point, $polygon, $tolerance = self::DEFAULT_TOLERANCE, $geodesic = true)
isLocationOnPath($point, $polyline, $tolerance = self::DEFAULT_TOLERANCE, $geodesic = true)
distanceToLine($p, $start, $end)
decode($encodedPath)
encode($path)

SphericalUtil 类

computeHeading($from, $to)
computeOffset($from, $distance, $heading)
computeOffsetOrigin($to, $distance, $heading)
interpolate($from, $to, $fraction)
computeDistanceBetween( $from, $to)
computeLength($path)
computeArea($path)
computeSignedArea($path)

containsLocation( $point, $polygon, $geodesic = false ) - 查找给定点是否在多边形内部

$point - ['lat' => 38.5, 'lng' => -120.2 ]
$polygon - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453]]
$geodesic - 布尔值

返回布尔值

$response =  \GeometryLibrary\PolyUtil::containsLocation(
              ['lat' => 23.886, 'lng' => -65.269], // point array [lat, lng]
             [ // poligon arrays of [lat, lng]
                ['lat' => 25.774, 'lng' => -80.190], 
                ['lat' => 18.466, 'lng' => -66.118], 
                ['lat' => 32.321, 'lng' => -64.757]
             ]);  
             
  echo $response; // false

isLocationOnEdge( $point, $polygon, $tolerance = self::DEFAULT_TOLERANCE, $geodesic = true ) - 确定一个点是否在折线或多边形边缘附近，在指定公差内（以米为单位）。

$point - ['lat' => 25.774, 'lng' => -80.190 ]
$polygon - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453]]
$tolerance - 公差值（以度为单位）
$geodesic - 布尔值

返回布尔值

$response =  \GeometryLibrary\PolyUtil::isLocationOnEdge(
              ['lat' => 25.774, 'lng' => -80.190], // point array [lat, lng]
              [ // poligon arrays of [lat, lng]
                ['lat' => 25.774, 'lng' => -80.190], 
                ['lat' => 18.466, 'lng' => -66.118], 
                ['lat' => 32.321, 'lng' => -64.757]
              ])  ;
              
  echo $response; // true

isLocationOnPath( $point, $polygon, $tolerance = self::DEFAULT_TOLERANCE, $geodesic = true ) - 确定一个点是否在折线附近，在指定公差内。

$point - ['lat' => 25.774, 'lng' => -80.190 ]
$polygon - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453]]
$tolerance - 公差值（以度为单位）
$geodesic - 布尔值

返回布尔值

$response =  \GeometryLibrary\PolyUtil::isLocationOnPath(
              ['lat' => 25.774, 'lng' => -80.190], // point array [lat, lng]
              [ // poligon arrays of [lat, lng]
                ['lat' => 25.774, 'lng' => -80.190], 
                ['lat' => 18.466, 'lng' => -66.118], 
                ['lat' => 32.321, 'lng' => -64.757]
              ])  ;
              
  echo $response; // true

distanceToLine( $p, $start, $end ) - 在球面上计算从一点到线段 start->end 的距离。

$p - ['lat' => 61.387002, 'lng' => 23.890636]
$start - ['lat' => 61.487002, 'lng' => 23.790636]
$end - ['lat' => 60.48047, 'lng' => 22.052754]

返回从点到线的距离

$response =  \GeometryLibrary\PolyUtil::distanceToLine(
              ['lat' => 61.387002, 'lng' => 23.890636], // point array [lat, lng]
              ['lat' => 61.487002, 'lng' => 23.790636], // line startpoint array [lat, lng]
              ['lat' => 60.48047, 'lng' => 22.052754] // line endpoint array [lat, lng]
             );  
             
  echo $response; // 12325.124046196 in meters

decode( $encodedPath ) - 将编码路径字符串解码为一系列经纬度。

$encodedPath - 字符串 '_piFps|U_ulLnnqC_mqNvxq`@''

返回数组

$response =  \GeometryLibrary\PolyUtil::decode('_p~iF~ps|U_ulLnnqC_mqNvxq`@');  

  echo $response; /** array (size=3)
                        0 => 
                          array (size=2)
                            'lat' => float 38.5
                            'lng' => float -120.2
                        1 => 
                          array (size=2)
                            'lat' => float 40.7
                            'lng' => float -120.95
                        2 => 
                          array (size=2)
                            'lat' => float 43.252
                            'lng' => float -126.453
                   */

encode( $path ) - 将一系列LatLng编码成编码路径字符串。

$path - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453] ]

返回字符串

$response =  \GeometryLibrary\PolyUtil::encode(
              [ 
                ['lat' => 38.5, 'lng' => -120.2], 
                ['lat' => 40.7, 'lng' => -120.95], 
                ['lat' => 43.252, 'lng' => -126.453]
              ]);
              
  echo $response; // '_p~iF~ps|U_ulLnnqC_mqNvxq`@'

computeHeading( $from, $to ) - 返回从一个LatLng到另一个LatLng的航向。

$from - ['lat' => 38.5, 'lng' => -120.2]
$to - ['lat' => 40.7, 'lng' => -120.95]

返回整数

$response =  \GeometryLibrary\SphericalUtil::computeHeading(
              ['lat' => 25.775, 'lng' => -80.190], 
              ['lat' => 21.774, 'lng' => -80.190]));
              
  echo $response; // -180

computeOffset( $from, $distance, $heading ) - 返回从起点沿指定航向移动一定距离后的LatLng。

$from - ['lat' => 38.5, 'lng' => -120.2]
$distance - 数字，要移动的距离
$heading - 数字，从北开始顺时针的航向角度

返回数组

$response =  \GeometryLibrary\SphericalUtil::computeOffset(['lat' => 25.775, 'lng' => -80.190], 152, 120);
              
  echo $response; /** array (size=2)
                      'lat' => float 25.774316510639
                      'lng' => float -80.188685385944
                  */

computeOffsetOrigin( $from, $distance, $heading ) - 提供了LatLng目的地、已行进距离和原始航向时，返回起点位置。航向以从北开始顺时针的角度表示。

$from - ['lat' => 38.5, 'lng' => -120.2]
$distance - 数字，要移动的距离
$heading - 数字，从北开始顺时针的航向角度

返回数组

$response =  \GeometryLibrary\SphericalUtil::computeOffsetOrigin(['lat' => 25.775, 'lng' => -80.190], 152, 120);
              
  echo $response; /** array (size=2)
                        'lat' => float 14.33435503928
                        'lng' => float -263248.24242931
                  */

interpolate( $from, $to, $fraction ) - 返回位于起点LatLng和目的地LatLng之间给定比例位置的LatLng。

$from - ['lat' => 38.5, 'lng' => -120.2]
$to - ['lat' => 38.5, 'lng' => -120.2]
$fraction - 数字，要行进距离的比例

返回数组

$response =  \GeometryLibrary\SphericalUtil::interpolate(['lat' => 25.775, 'lng' => -80.190], 
                                                          ['lat' => 26.215, 'lng' => -81.218], 2);
              
  echo $response; /** array (size=2)
                      'lat' => float 26.647635362403
                      'lng' => float -82.253737943391
                  */

computeDistanceBetween( $from, $to ) - 返回两个LatLng之间的距离（以米为单位）。您可以指定一个自定义半径。默认半径为地球半径。

$from - ['lat' => 38.5, 'lng' => -120.2]
$to - ['lat' => 38.5, 'lng' => -120.2]

返回浮点数

$response =  \GeometryLibrary\SphericalUtil::computeDistanceBetween(['lat' => 25.775, 'lng' => -80.190], ['lat' => 26.215, 'lng' => -81.218]);
              
  echo $response; //float 113797.92421349

computeLength( $path ) - 返回给定路径在地球上的长度（以米为单位）。

$path - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453] ]

返回浮点数

$response =  \GeometryLibrary\SphericalUtil::computeLength([ 
                ['lat' => 38.5, 'lng' => -120.2], 
                ['lat' => 40.7, 'lng' => -120.95], 
                ['lat' => 43.252, 'lng' => -126.453]
              ]);
              
  echo $response; //float 788906.98459431

computeArea( $path ) - 返回闭合路径的面积。

$path - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453] ]

返回浮点数

$response =  \GeometryLibrary\SphericalUtil::computeArea([ 
                ['lat' => 38.5, 'lng' => -120.2], 
                ['lat' => 40.7, 'lng' => -120.95], 
                ['lat' => 43.252, 'lng' => -126.453]
              ]);
              
  echo $response; //float 44766785529.143

computeSignedArea( $path ) - 返回闭合路径的带符号面积。

$path - [ ['lat' => 38.5, 'lng' => -120.2], ['lat' => 40.7, 'lng' => -120.95], ['lat' => 43.252, 'lng' => -126.453] ]

返回浮点数

$response =  \GeometryLibrary\SphericalUtil::computeSignedArea([ 
                ['lat' => 38.5, 'lng' => -120.2], 
                ['lat' => 40.7, 'lng' => -120.95], 
                ['lat' => 43.252, 'lng' => -126.453]
              ]);
              
  echo $response; //float 44766785529.143

支持

请在GitHub上提交问题

许可证

Google Maps API V3的几何库以MIT许可证发布。有关详细信息，请参阅捆绑的LICENSE文件。

brianfp / geometry-library

维护者

详细信息

README

功能

依赖

安装

用法

可用方法

PolyUtil 类

SphericalUtil 类

支持

许可证