WRLD iOS SDK

WRLD iOS SDK 是一个框架，用于在 Cocoa Touch 应用程序中显示精美、交互式的 3D 地图视图，适用于 iPhone 或 iPad。地图视图可以嵌入到应用程序中，使用 iOS 8.0 或更高版本，使用 Objective-C，或者通过简单地使用 Xcode Interface Builder 连接。

有关更多信息，请参阅 WRLD iOS API 文档页面。

安装

WRLD iOS SDK 作为动态框架提供。要将 SDK 与应用程序集成，您需要 Xcode 7.3 或更高版本。

您可以直接下载安装，或通过 CocoaPods 安装。

使用直接下载安装

1. 从 最新 gitHub 发布 页面，下载 wrld-ios-sdk zip 文件。
2. 在 Xcode 中，在项目导航器中选择您的应用程序项目以显示项目编辑器。选择应用程序的目标，然后在 General 选项卡中找到 Embedded Binaries 部分。
3. 解压 wrld-ios-sdk zip 文件并将 WRLD.framework 拖入 Embedded Binaries 部分。在随后出现的对话框中检查 "Copy items if needed"，然后单击 "Finish"。这将链接 WRLD.framework 与您的项目。
4. 获得 WRLD API 密钥 并将其设置在您的应用程序的 Info.plist 文件中。

使用 CocoaPods 安装

• 安装 CocoaPods。
• 在您的应用程序项目的根文件夹中创建一个 Podfile（根据您的应用程序适当替换 'MyAppTargetName'）

platform :ios, '8.0'

target 'MyAppTargetName' do
  pod 'WRLD'
end

• 在终端中运行 pod install。这将下载 SDK 并创建一个 xcworkspace 文件。在 Xcode 中打开此文件。
• 获得 WRLD API 密钥 并将其设置在您的应用程序的 Info.plist 文件中。

WRLD API 密钥

为了使用 WRLD iOS API，您必须注册一个 免费开发者帐户。

注册后，创建一个 API 密钥（为了清晰起见，这是一个包含 32 个字符的令牌）。API 密钥对于使用 WRLD 地图服务是必需的。为了安全起见，为您的每个应用程序创建一个新的 API 密钥 - 如果需要吊销一个密钥，这限制了必要的更改。

为了向您的应用程序提供 API 密钥，在 Xcode 中打开您的应用程序的 Info.plist 文件（在项目导航器中选中它）。

在您的应用程序中使用地图视图

现在您已安装 WRLD iOS SDK，您可以将 WRLD 3D 地图视图集成到您的应用程序中。

以下步骤指南展示了如何使用 Xcode Interface Builder 将 WRLD 地图视图集成到您的 iOS 应用程序中。

设置您的 WRLD API 密钥

在 Xcode 中，在项目导航器中选择您的应用程序的 Info.plist 文件。

添加包含以下列的条目

• 键: WrldApiKey
• 类型: String
• 值: [您的 API 密钥]

使用 Storyboards 添加地图视图

1. 在项目导航器中选择您的应用程序的 Main.storyboard。
2. 将 Storyboard View Controller Scene 展开到您想要添加地图视图的位置。
3. 从对象库中，通过UIView进行筛选，并将一个新的View对象拖入您的Storyboard。
4. 或者，要更改现有的UIView以显示WRLD地图，只需在Storyboard中选择视图。
5. 在实用工具侧栏中，选择标识检查器。
6. 将视图的类更改为WRLDMapView。

设置地图的起始位置

1. 在选中WRLDMapView的情况下，打开属性检查器。
2. 在地图视图部分，设置以下内容

Start Latitude: 37.789069 
Start Longitude: -122.401141
Start Zoom Level: 15
Start Direction: 0

这将配置地图视图以从旧金山开始，并且视图的顶部与北对齐。

更改'启用 Bitcode'设置

当前WRLD iOS SDK不支持Bitcode。根据您使用的Xcode版本，您可能需要禁用项目设置中的此选项。

1. 在项目编辑器中，选择构建设置。
2. 在构建选项下，确保'启用Bitcode'设置为否。

构建并运行您的应用

现在您可以尝试您的应用了。

1. 选择目标设备

2. 在工具栏中，单击'构建并运行当前方案'按钮。

   

应用将现在安装并运行在您的设备上。如果您选择的是模拟器iOS目标设备，模拟器将启动并运行您的应用。

添加包含以下列的条目

• 键: WrldApiKey
• 类型: String
• 值: [您的 API 密钥]

在代码中创建WRLDMapView

上述指南显示了如何使用Xcode界面构建器将WRLDMapView嵌入到iOS应用中。

WRLDMapView实例也可以使用Objective-C实例化并添加到视图控制器中 - 参见以下片段。

@import Wrld;

@interface ViewController : UIViewController
@end

@implementation ViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    WRLDMapView *mapView = [[WRLDMapView alloc] initWithFrame:self.view.bounds];
    
    mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
    
    // set the center of the map and the zoom level
    [mapView setCenterCoordinate:CLLocationCoordinate2DMake(37.7858, -122.401)
                        zoomLevel:15
                         animated:NO];
    
    [self.view addSubview:mapView];
}

@end

状态

WRLD iOS SDK目前处于alpha版本，正在积极开发中 - 我们将结合更多功能和改进进行扩展。

更多信息

请参阅我们的API文档和示例。

示例GitHub仓库包含一个开源iOS应用，展示了API功能。

问题、评论或问题？所有反馈都受欢迎 - 在问题页面联系。

许可

WRLD iOS SDK在简化版BSD许可证下发布。有关详细信息，请参阅LICENSE.md文件。