Mapzen iOS SDK

Mapzen iOS SDK 是一个薄包装，封装了您在 iOS 应用中使用 Mapzen 服务所需的一切。

我们欢迎社区对其使用的反馈。也欢迎功能请求；适当地将其标记为 "增强"。您也可以通过https://mapzen.com/上的其他任何渠道联系我们。

使用方法

开始使用 Mapzen SDK 所需的一切

设置

• 安装
• 入门

与地图交互

• 位置、旋转、缩放和倾斜
• 标记、多边形和线段
• 切换样式
• 手势代理
• 当前位置

搜索和路线规划

• 搜索
• 路线规划

包含内容

主要功能包括

• 使用由 Tangram-es 提供的 OpenGL ES 进行高性能和高度可定制的地图渲染。
• 提供由 Mapzen Turn-by-Turn 提供的驾驶说明书和自定义路线线。
• 提供由 Mapzen Search 提供的地址编码和兴趣点搜索。
• 提供几种 基本地图样式，适用于大多数使用场景。

以及许多在此处及时列出之外的更多功能。

我如何获取 SDK？

步骤 1：免费获取 Mapzen API 密钥。

步骤 2：通过 Cocoapods 安装 SDK。

步骤 3：查看示例应用程序的 源代码 或运行 pod try Mapzen-ios-sdk 以立即加载。您需要从第一步获取 API 密钥。请参阅以下设置位置。

步骤 4：让我们知道您的想法！您可以在 GitHub 上打开 新问题 或通过 [email protected] 电子邮件来联系我们。

非 Cocoapods 使用

在此阶段不建议使用非 Cocoapods，但仍然可以完成。首先，确保在克隆此仓库后，执行 git submodule update --init --recursive 以获取所有样式表。其次，你还需要包含我们所需的 3 个其他依赖项：Tangram-es、OnTheRoad for iOS 和 Pelias iOS SDK。注意，你的项目需要支持 Swift 3。

注意

以下是一些你需要提前了解的事情

• 我们将仅支持 Swift 3.x。旧版本的 SDK 是用 Swift 2 编写的，但强烈建议不要使用它，因为自那时以来项目已经发生了巨大的变化，我们一直在不断添加新功能。
• 如果你希望将示例应用安装到设备上（由于模拟器的性能问题，建议这样做），你需要在 Xcode 项目的“Bundle Identifier”和“Code Signing”中更新，并执行必要的通用代码签名流程。这需要一个免费的苹果开发者账号。
• 如果你决定使用 Cocoapods 并直接从 master 分支拉取，你需要在 podfile 中添加 :submodules => true。否则，子模块将无法加载。完整行将类似于：pod "Mapzen-ios-sdk", :git => 'https://github.com/mapzen/ios.git', :branch => 'master', :submodules => true

配置示例应用 API 密钥

在示例应用中设置 API 密钥有两种（可选三种）方法

1. 更新 SampleApp/Info.plist

将 $(MAPZEN_API_KEY) 替换为你的密钥

或者 -

2. 创建一个新的方案并添加一个环境变量

复制 ios-sdk 方案，然后在这里添加你的环境变量

或者 -

3. 手动修改 Sample App 的 AppDelegate.swift 中的代码，第 31 行，以使用你的 API 密钥。请注意，这将会生成关于未使用代码的警告。