Coordinates and Distances

gcj02tobd09(lng, lat)

Convert coordinates from GCJ02 to BD09

gcj02towgs84(lng, lat)

Convert coordinates from GCJ02 to WGS84

wgs84togcj02(lng, lat)

Convert coordinates from WGS84 to GCJ02

wgs84tobd09(lon, lat)

Convert coordinates from WGS84 to BD09

bd09togcj02(bd_lon, bd_lat)

Convert coordinates from BD09 to GCJ02

bd09towgs84(lon, lat)

Convert coordinates from BD09 to WGS84

bd09mctobd09(x, y)

Convert coordinates from BD09MC to BD09

transform_shape(gdf, method)

Convert coordinates of all data.

getdistance(lon1, lat1, lon2, lat2)

Input the origin/destination location in the sequence of [lon1, lat1, lon2, lat2] (in decimal) from DataFrame.

Coordinate convertering method

TransBigData package provides quick converting of coordinates such as GCJ02, BD09, BD09mc, WGS94

transbigdata.gcj02tobd09(lng, lat)

Convert coordinates from GCJ02 to BD09

Parameters:

  • lng (Series or number) – Longitude

  • lat (Series or number) – Latitude

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

transbigdata.bd09togcj02(bd_lon, bd_lat)

Convert coordinates from BD09 to GCJ02

Parameters:

  • lng (Series or number) – Longitude

  • lat (Series or number) – Latitude

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

transbigdata.wgs84togcj02(lng, lat)

Convert coordinates from WGS84 to GCJ02

Parameters:

  • lng (Series or number) – Longitude

  • lat (Series or number) – Latitude

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

transbigdata.gcj02towgs84(lng, lat)

Convert coordinates from GCJ02 to WGS84

Parameters:

  • lng (Series or number) – Longitude

  • lat (Series or number) – Latitude

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

transbigdata.wgs84tobd09(lon, lat)

Convert coordinates from WGS84 to BD09

Parameters:

  • lng (Series or number) – Longitude

  • lat (Series or number) – Latitude

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

transbigdata.bd09towgs84(lon, lat)

Convert coordinates from BD09 to WGS84

Parameters:

  • lng (Series or number) – Longitude

  • lat (Series or number) – Latitude

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

transbigdata.bd09mctobd09(x, y)

Convert coordinates from BD09MC to BD09

Parameters:

  • x (Series or number) – x coordinates

  • y (Series or number) – y coordinates

Returns:

  • lng (Series or number) – Longitude (Converted)

  • lat (Series or number) – Latitude (Converted)

Coordinates reciprocal converting, based on numpy column computation:

>>> data['Lng'],data['Lat'] = tbd.wgs84tobd09(data['Lng'],data['Lat'])
>>> data['Lng'],data['Lat'] = tbd.wgs84togcj02(data['Lng'],data['Lat'])
>>> data['Lng'],data['Lat'] = tbd.gcj02tobd09(data['Lng'],data['Lat'])
>>> data['Lng'],data['Lat'] = tbd.gcj02towgs84(data['Lng'],data['Lat'])
>>> data['Lng'],data['Lat'] = tbd.bd09togcj02(data['Lng'],data['Lat'])
>>> data['Lng'],data['Lat'] = tbd.bd09towgs84(data['Lng'],data['Lat'])
>>> data['Lng'],data['Lat'] = tbd.bd09mctobd09(data['Lng'],data['Lat'])

Convert coordinates of the geographic elements

transbigdata.transform_shape(gdf, method)

Convert coordinates of all data. The input is the geographic elements’ DataFrame.

Parameters:

  • gdf (GeoDataFrame) – Geographic elements

  • method (function) – The coordinate converting function

Returns:

gdf – The result of converting

Return type:

GeoDataFrame

Distance measurment

transbigdata.getdistance(lon1, lat1, lon2, lat2)

Input the origin/destination location in the sequence of [lon1, lat1, lon2, lat2] (in decimal) from DataFrame. The output is the distance (m).

Parameters:

  • lon1 (Series or number) – Start longitude

  • lat1 (Series or number) – Start latitude

  • lon2 (Series or number) – End longitude

  • lat2 (Series or number) – End latitude

Returns:

distance – The distance

Return type:

Series or number