适用于 iOS 的 Google Directions API SDK，完全使用 Swift 编写。
- 支持截至 2018 年 8 月的 Google Directions API 的所有功能（完整列表请参见此处：https://developers.google.com/maps/documentation/directions）
- 支持“在 Google 地图应用中打开”，既支持特定位置也支持路线请求
- 也支持回调功能，以便用户在 Google 地图应用中操作完成后返回你的应用
- 如果未安装 Google 地图应用，则支持回退到内置的 Apple 地图应用
- 提供现代的 Swift 风格完成块 (completion block) 或 Objective-C 风格的代理模式
- 查询通过 HTTPS 进行
- 后台使用 JSON 来帮助减少响应大小
- 可通过 CocoaPods 和 Carthage 获取
- 与 Google Places ID 兼容（用法：
PXLocation.googlePlaceId("gplaceid")，或者如果已经使用了 Google 的 Places SDK for iOS，则使用PXLocation.googlePlaceId(gmsPlace.placeID)） - 与 Swift 4.2 兼容
- 更新到 Google Maps iOS SDK 2.7
通过 Swift Package Manager 提供(V1.6 已取消)
- 更新到 Google Maps iOS SDK 2.5
- PXGoogleDirections Pod 现在作为静态库发布（需要 Cocoapods 1.4.0）
- 其他错误修复
- 与 Swift 4 兼容
- 可通过 Carthage 获取
- 略微改进了将此 pod 与 Google Maps 和/或 Google Places pod 混合的项目（但将 Google Maps iOS SDK 与其他 Pod 混合仍然很糟糕...）
- 完全支持 Swift 3
- 完全支持 Google Maps iOS SDK 2.0+
- 在
PXGoogleDirections类中添加了trafficModel属性，以匹配 API 中的 Google 属性（最近添加）；它仅适用于驾驶路线，并且在指定出发日期时才有效 - 修复了一个错误，该错误导致绘制路线只会绘制来自路线对象的基本、粗略的表示；现在可以选择在
PXGoogleDirectionsRoute类的drawOnMap方法中绘制详细路线 - 其他小错误修复
- 在 iOS 9.3 及更高版本上运行。
- 与 Swift 4 / Xcode 9 及更高版本兼容。
- 如果使用 Swift 3 和/或 Xcode 8，请使用 v1.3。
- 如果需要与先前版本的 Swift 兼容，请使用 v1.2.3。
- 该 SDK 依赖于官方的 Google Maps SDK for iOS（更多信息请参见此处：Google Maps iOS SDK）
要在项目中使用 PXGoogleDirections，请将以下行添加到 Cartfile 中
github "Poulpix/PXGoogleDirections"
或者，如果您希望以特定版本的库为目标，只需将其附加到
Carttfile中行的末尾，例如：github "Poulpix/PXGoogleDirections" ~> 1.5。
然后从终端运行以下命令
carthage update
最后，返回 Xcode，将生成的框架拖放到目标“General”选项卡的“Embedded Binaries”部分。 该框架应位于 Xcode 项目的 Carthage/Build/iOS 子文件夹中。
重要提示：Carthage 仅从该库的 1.4 版本开始支持。 此库的先前版本将不起作用。
要在项目中使用 PXGoogleDirections，请将以下 Podfile 添加到您的项目中
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.3'
use_frameworks!
pod 'PXGoogleDirections'
然后从终端运行以下命令
pod install
重要提示：如果您的项目既需要 PXGoogleDirections 又需要 Google Maps 和/或 Google Places iOS SDK，您将会遇到问题。 请参阅下面的“与 Google pods 兼容性”段落，如果您需要帮助，请随时与我联系并描述您的问题！
如果您希望避免 Google Maps iOS SDK 与该库的已知冲突问题，则首选从原始源代码构建。 但是，您将缺少 Cocoapods 和 Carthage 框架提供的自动化和版本更新。
要从源代码构建，请按照以下简单步骤操作
- 克隆存储库
- 将整个
PXGoogleDirections项目添加到您自己的 Xcode 项目 - 在两个项目之间添加依赖项并构建
- 不要忘记将
PXGoogleDirections项目的输出 (PXGoogleDirections.framework) 添加到 Xcode 项目主目标的“Embedded Binaries”部分
在两行 Swift 代码中快速入门
- 像这样引用该库
import PXGoogleDirections
- 创建一个 API 对象
let directionsAPI = PXGoogleDirections(apiKey: "<insert your Google API key here>",
from: PXLocation.coordinateLocation(CLLocationCoordinate2DMake(37.331690, -122.030762)),
to: PXLocation.specificLocation("Googleplex", "Mountain View", "United States"))
- 运行 Directions 请求
directionsAPI.calculateDirections({ response in
switch response {
case let .error(_, error):
// Oops, something bad happened, see the error object for more information
break
case let .success(request, routes):
// Do your work with the routes object array here
break
}
})
重要提示：通常不需要自己调用
GMSServices.provideAPIKey()：PXGoogleDirections 在初始化 SDK 时会调用它。
有关可用属性和响应数据的更多信息，请参见下面的“文档”。
该 SDK 在 Xcode 中提供了集成的文档，并提供完整的自动完成支持。
为了帮助您入门，在此存储库的“Sample”子文件夹中还提供了一个示例项目。
它旨在演示 API 和 SDK 的主要功能。
自 V1.3 以来，PXGoogleDirections 使用 Google 的最新 Google Maps iOS SDK 分支，该分支现已拆分为更小、更模块化的框架。 PXGoogleDirections 依赖于其中的三个
GoogleMapsCoreGoogleMapsBaseGoogleMaps
不需要 Google Places iOS SDK。
如果您的应用还需要 Google Maps iOS SDK（例如，用于在地图上绘图），由于与 pod 中捆绑的 Google Maps iOS SDK 冲突，您将会遇到麻烦。 这是因为 Google 将其 pod 作为静态框架而不是动态框架发布的方式所致。
这是迄今为止已知的唯一解决方法
- 从您的 Podfile 中删除 PXGoogleDirections 并执行
pod update。 - 将所有 Google 依赖项添加到您的 Podfile（例如：
pod GoogleMaps、pod GooglePlaces）并执行pod update。 - 在您的文件夹的根文件夹中打开一个终端，并将 PXGoogleDirections 引用为 git 子模块，如下所示
git submodule add https://github.com/poulpix/PXGoogleDirections.git Frameworks/External/PXGoogleDirections
这会将所有 PXGoogleDirections 项目下载到您自己的项目的子文件夹中 (Frameworks/External/PXGoogleDirections)。 当然，您可以根据需要更改此路径。
重要提示：您还可以通过将
-b <branch>开关添加到git submodule命令来请求该框架的特定版本，如下所示
git submodule add -b <branch> https://github.com/poulpix/PXGoogleDirections.git Frameworks/External/PXGoogleDirections要查找适当的分支名称，请查看 Github 上的所有可用分支
-
更新您的 Podfile 以提供有关如何构建您的项目和 PXGoogleDirections 子模块的说明
source 'https://github.com/CocoaPods/Specs.git' workspace 'test.xcworkspace' # Your project's workspace project 'test.xcodeproj' # Your project's Xcode project project 'Frameworks/External/PXGoogleDirections/PXGoogleDirections.xcodeproj' # Update folder structure if needed target 'test' do project 'test.xcodeproj' platform :ios, '10.0' # Update for your needs use_frameworks! # Update these lines depending on which Google pods you need pod 'GoogleMaps' pod 'GooglePlaces' # Other pods... end # This tells Cocoapods how to build the subproject target 'PXGoogleDirections' do project 'Frameworks/External/PXGoogleDirections/PXGoogleDirections.xcodeproj' platform :ios, '9.3' pod 'GoogleMaps' end -
现在您需要在两个位置执行
pod install
- 您的项目的根目录，
- PXGoogleDirections 子模块的根目录（例如
Frameworks/External/PXGoogleDirections）。
- 使用您的 project.xcworkspace 打开 Xcode 并构建 PXGoogleDirections 目标，然后构建您的应用程序目标。 一切都应该正确构建。
根据您的设置，您可能会看到以下一个或多个已知问题
-
运行时（通常是应用程序启动时）出现大量类似这样的消息：
Class GMSxxx_whatever is implemented in both (name of your app) and (reference to PXGoogleDirections framework). One of the two will be used. Which one is undefined.这是因为使用 Carthage 或 Cocoapods，您通常会拥有两个版本的 Google Maps iOS SDK：一个已与 PXGoogleDirections 库链接，另一个是如果您希望显式使用它，您将被迫在自己的应用程序中链接到的版本。 从我所看到的，只要两个版本等效，这些警告就不会产生实际影响。 它们只会污染运行时输出控制台。 -
运行时出现类似这样的消息（通常在显示 Google 地图视图时）：
Main Thread Checker: UI API called on a background thread: -[UIApplication setNetworkActivityIndicatorVisible:]此行为是 Xcode 9 中新增的，罪魁祸首似乎是 Google Maps iOS SDK 本身，而不是库提供的示例应用程序。 这些消息并非真正有害，但也不正常。 如果您找到解决方案，请私信我！ -
该框架尚未为 Swift Package Manager 做好准备，因为它需要静态链接到 Google Maps iOS SDK 并包含 Google Maps 资源包； 目前，这两项任务都无法通过 Swift Package Manager 完成。
- 代码的某些部分受到 Google Maps 团队的 OpenInGoogleMaps-iOS 的启发。
- 感谢 @embasssem 提供了使用 Google SDK 的解决方法 (#28)。
PXGoogleDirections SDK 在 New BSD 许可下获得许可。（更多信息请参见 LICENSE。）
请随时在 Github、Twitter、Stack Overflow 上或通过电子邮件给我留言
- https://github.com/poulpix
- https://twitter.com/_RomainL
- http://stackoverflow.com/users/145997/romain
- dev (dot) romain (at) me.com