坐标系统转换

作者：康 林 kl222@126.com

• 项目地址：https://github.com/KangLin/TransformCoordinate
• 镜像地址：
• https://gitlab.com/kl222/TransformCoordinate
• https://sourceforge.net/projects/transformcoordinate/
• https://gitee.com/kl222/TransformCoordinate

介绍

本项目对WGS84、GCJ02、百度坐标系之间进行转换。

• WGS84：
  为一种大地坐标系，也是目前广泛使用的全球卫星定位系统（GPS）使用的坐标系。
• GCJ02：
  戏称火星坐标系，是由中国国家测绘局制定的地理坐标系统，是由WGS84加密后得到的坐标系。
• BD09：
  为百度坐标系，在GCJ02坐标系基础上再次加密。
  其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标。

本项目还包括一个GPX文件操作模块。

本项目包含：

• C++ 库：
• 坐标转换库：TransformCoordinate
• GPX文件操作库：GpxModel
• 坐标转换程序：TransformCoordinateApp

支持平台

• Windows 7 SP2 及以后
• Linux
• Android
• MacOS
• IPHONE

注意: 本人没有 MacOS 和 IPHONE 设备。请有设备的朋友自行测试，并进行反馈。
也可以向本人捐赠资金或相关设备，请联系：kl222@126.com

详见：Qt5 支持平台、Qt6 支持平台。

下载安装包

• Ubuntu

• 包含玉兔公共库(RabbitCommon)

  • 开发库 libtransformcoordinate-dev_1.1.2_RabbitCommon_amd64.deb
  • 运行库 libtransformcoordinate_1.1.2_RabbitCommon_amd64.deb
  • 转换示例程序 transformcoordinate_1.1.2_RabbitCommon_amd64.deb

  • 安装

    sudo apt install ./libtransformcoordinate_1.1.2_RabbitCommon_amd64.deb \
    ./transformcoordinate_1.1.2_RabbitCommon_amd64.deb

• 不包含玉兔公共库(RabbitCommon)。安装前需要先从 RabbitCommon 下载，并安装 RabbitCommon。

  • 开发库 libtransformcoordinate-dev_1.1.2_amd64.deb
  • 运行库 libtransformcoordinate_1.1.2_amd64.deb
  • 转换示例程序 transformcoordinate_1.1.2_amd64.deb

• Windows

• TransformCoordinate_v1.1.2_win64_msvc2019_64_qt6.6.3_Setup.exe
• TransformCoordinate_v1.1.2_win32_msvc2017_qt5.12.12_Setup.exe
• Android
• TransformCoordinate_1.1.2_android_arm64_v8a_qt6.6.3_Release.apk
• TransformCoordinate_1.1.2_android_x86_64_qt6.6.3_Release.apk
• 更多的下载包

编译

下载源码

git clone https://github.com/KangLin/TransformCoordinate.git

依赖

• 编译工具
• Qt
• 编译器
  • For linux or android
    • GNU Make 工具
    • GCC 或者 Clang 编译器
  • For windows
    • MSVC
    • MinGW
• CMake
• 依赖库
• [必选] Rabbit 公共库(RabbitCommon):
  • 源码： https://github.com/KangLin/RabbitCommon
  • 开发包： https://github.com/KangLin/RabbitCommon/releases

CMake 配置参数

• [必选] QT_DIR: qt 安装位置
  • [可选] Qt5_DIR: qt5 安装位置
  • [可选] Qt6_DIR: qt6 安装位置
• [可选] RabbitCommon_DIR: RabbitCommon 源码位置

各平台编译

linux 平台编译说明

• 编译

  git clone https://github.com/KangLin/RabbitCommon.git
  git clone https://github.com/KangLin/TransformCoordinate.git
  cd TransformCoordinate
  mkdir build
  cd build
  cmake .. -DCMAKE_INSTALL_PREFIX=pwd/install \
  -DCMAKE_BUILD_TYPE=Release \
  -DQT_DIR=...... \
  -DQt6_DIR=...... \
  -DRabbitCommon_DIR= \
  [其它可选 CMake 配置参数]
  cmake --build . --config Release

• 打包

  cmake --build . --config Release --target package

• 运行例子

• [可选] 把生成库的目录加入到变量 LD_LIBRARY_PATH 中

  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`/lib
  

• 执行 bin 目录下的程序

  cd TransformCoordinate
  cd build
  cd bin
  ./TransformCoordinateApp
  

windows 平台编译说明

• 使用 cmake-gui.exe 工具编译。打开 cmake-gui.exe 配置
• 命令行编译
• 把 cmake 命令所在目录加入到环境变量 PATH 中

• 从开始菜单打开 “VS2015开发人员命令提示”，进入命令行

  • 编译

    cd TransformCoordinate
    mkdir build
    cd build
    cmake .. -DCMAKE_INSTALL_PREFIX=pwd/install ^
    -DCMAKE_BUILD_TYPE=Release ^
    -DQT_DIR=...... ^
    -DQt6_DIR=...... ^
    -DRabbitCommon_DIR= ^
    [其它可选 CMake 配置参数]
    cmake --build . --config Release

  • 打包

    cmake --build . --config Release --target package

  • 运行例子

  • 执行 bin 目录下的程序
    • TransformCoordinateApp.exe

Android 平台编译说明

• 安装 ndk 编译工具
• 从 https://developer.android.com/ndk/downloads 下载 ndk，并安装到：/home/android-ndk

• 设置环境变量：

  export ANDROID_NDK=/home/android-ndk
  

• 安装 sdk 工具

• 从 https://developer.android.google.cn/studio/releases 下载 sdk tools, 并安装到 /home/android-sdk

• 设置环境变量：

  export ANDROID_SDK=/home/android-sdk
  

• 编译

• 主机是 linux

  cd TransformCoordinate
  mkdir build
  cd build
  cmake .. -DCMAKE_INSTALL_PREFIX=`pwd`/android-build \
           -DCMAKE_BUILD_TYPE=Release \
           -DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake \
           -DANDROID_ABI="armeabi-v7a with NEON" \
           -DANDROID_PLATFORM=android-18 \
           -DQT_DIR=...... \
           -DQt6_DIR=...... \
           -DRabbitCommon_DIR= \
           [其它可选 CMake 配置参数]
  cmake --build . --config Release --target package
  

• 主机是 windows

  cd TransformCoordinate
  mkdir build
  cd build
  cmake .. -DCMAKE_INSTALL_PREFIX=`pwd`/android-build ^
           -G"Unix Makefiles" -DCMAKE_BUILD_TYPE=Release ^
           -DCMAKE_TOOLCHAIN_FILE=${ANDROID_NDK}/build/cmake/android.toolchain.cmake ^
           -DCMAKE_MAKE_PROGRAM=${ANDROID_NDK}/prebuilt/windows-x86_64/bin/make.exe ^
           -DANDROID_ABI=arm64-v8a ^
           -DANDROID_ARM_NEON=ON ^
           -DQT_DIR=...... ^
           -DQt6_DIR=...... ^
           -DRabbitCommon_DIR= ^
           [其它可选 CMake 配置参数]
  cmake --build . --config Release --target package
  

• CMake for android 参数说明：https://developer.android.google.cn/ndk/guides/cmake

  • ANDROID_ABI: 可取下列值：
    目标 ABI。如果未指定目标 ABI，则 CMake 默认使用 armeabi-v7a。
    有效的目标名称为：
  • armeabi：带软件浮点运算并基于 ARMv5TE 的 CPU。
  • armeabi-v7a：带硬件 FPU 指令 (VFPv3_D16) 并基于 ARMv7 的设备。
  • armeabi-v7a with NEON：与 armeabi-v7a 相同，但启用 NEON 浮点指令。这相当于设置 -DANDROID_ABI=armeabi-v7a 和 -DANDROID_ARM_NEON=ON。
  • arm64-v8a：ARMv8 AArch64 指令集。
  • x86：IA-32 指令集。
  • x86_64 - 用于 x86-64 架构的指令集。
  • ANDROID_NDK \<path> 主机上安装的 NDK 根目录的绝对路径
  • ANDROID_PLATFORM: 如需平台名称和对应 Android 系统映像的完整列表，请参阅 Android NDK 原生 API
  • ANDROID_ARM_MODE
  • ANDROID_ARM_NEON
  • ANDROID_STL: 指定 CMake 应使用的 STL。默认情况下，CMake 使用 c++_static。
  • c++_shared: 使用 libc++ 动态库
  • c++_static: 使用 libc++ 静态库
  • none: 没有 C++ 库支持
  • system: 用系统的 STL

• 安装 apk 到设备

  adb install android-build-debug.apk

MacOS 平台编译说明

• 编译

  cd TransformCoordinate
  mkdir build
  cd build
  cmake .. -DCMAKE_INSTALL_PREFIX=pwd/install \
  -DCMAKE_BUILD_TYPE=Release \
  -DQT_DIR=...... \
  -DQt6_DIR=...... \
  -DRabbitCommon_DIR= \
  [其它可选 CMake 配置参数]
  cmake --build . --config Release

• 打包

  cmake --build . --config Release --target package

使用 C++ 库

• 坐标转换库:

• 在程序 CMakeLists.txt 中加入下面行

  find_package(TransformCoordinate)
  target_link_libraries(${PROJECT_NAME} PRIVATE TransformCoordinate)
  

• 接口详见： TransformCoordinate

• GPX文件操作库:

• 编译时，需要设置 CMake 参数: WITH_GPXMODEL=ON

• 在程序 CMakeLists.txt 中加入下面行

  find_package(GpxModel)
  target_link_libraries(${PROJECT_NAME} PRIVATE GpxModel)
  

• 接口详见: GpxModel

脚本

• build_debpackage.sh

• 此脚本是 linux 下生成 deb 包的。使用前，请确保安装了下面程序

  sudo apt-get install debhelper fakeroot
  

• 用系统自带的 QT

  sudo apt-get install \
      qt6-tools-dev qt6-tools-dev-tools \
      qt6-base-dev qt6-base-dev-tools qt6-qpa-plugins \
      libqt6svg6-dev qt6-l10n-tools qt6-translations-l10n \
      qt6-scxml-dev qt6-multimedia-dev libqt6serialport6-dev \
      qt6-webengine-dev qt6-webengine-dev-tools
  

• 详见: ubuntu.yml

• 注意:

  • 如果使用 RabbitCommon 源码编译，则本库安装的库位于： /opt/TransformCoordinate
  • 如果使用 RabbitCommon 安装包编译，则本库安装于系统目录: /usr

• deploy.sh: 此脚本用于产生新的发行版本号和标签。仅程序发布者使用。

捐赠:

本软件如果对你有用，或者你喜欢它，请你捐赠，支持作者。谢谢！