OpenCageSDK

要求

OpenCageSDK适用于iOS 9+，并需要ARC进行构建。它依赖于以下Apple框架，这些框架通常已包含在大多数Xcode模板中

• Foundation.framework

为了构建OpenCageSDK，您需要最新的开发工具。旧的Xcode版本可能也可以工作，但不会明确维护兼容性。

您还需要从OpenCage获取API密钥来初始化此SDK。API密钥可以从这里获取：https://geocoder.opencagedata.com/

将OpenCageSDK添加到您的项目中

CocoaPods

CocoaPods是将OpenCageSDK添加到项目的推荐方法。

1. 在Podfile中为OpenCageSDK添加条目pod 'OpenCageSDK'
2. 通过运行pod install来安装pod（s）
3. 使用@import OpenCageSDK在需要的地方包含OpenCageSDK

源文件

或者，您可以直接将源文件添加到项目中，它们位于OpenCageSDK/Classes中。

1. 下载最新代码版本或将存储库作为git子模块添加到您的git-tracked项目。
2. 在Xcode中打开您的项目，然后将类拖放到项目中（使用"Product Navigator视图"）。如果问是否在项目外提取了代码归档，请确保选择复制项目。

静态库

您还可以将OpenCageSDK作为静态库添加到您的项目或工作空间中。

1. 下载最新代码版本或将存储库作为git子模块添加到您的git-tracked项目。
2. 在Xcode中打开您的项目，然后将其拖放到项目或工作空间中（使用"Product Navigator视图"）。
3. 选择您的目标并转到"构建阶段"选项卡。在"链接二进制与库"部分选择添加按钮。在表格中找到并添加OpenCageSDK。您可能还需要将OpenCageSDK添加到目标依赖列表中。
4. 在Objective-C中，您可能需要使用#import [yourprojectname]-swift.h包含OpenCageSDK。

用法

OpenCageSDK基于NSURLSession构建，带有completionBlock，因此网络请求发生在后台线程上。设置SDK有一个便利的初始化器。

let ocSDK :OCSDK = OCSDK(apiKey: "YOUR-API-KEY")

OCSDK *sdk = [[OCSDK alloc] initWithApiKey:@"YOUR-API-KEY"];

反向地理编码通过以下方法执行，请求中发生的任何错误都位于completionBlock 'error'中。服务器的响应解析为对象以便于访问。

let ocSDK :OCSDK = OCSDK(apiKey: "YOUR-API-KEY")
ocSDK.reverseGeocode(latitude: NSNumber(value: 51.5159), longitude: NSNumber(value: 0.1297), withAnnotations: true) { (response, success, error) in
    if success {
		//Successful payload response
    }
}

OCSDK *sdk = [[OCSDK alloc] initWithApiKey:@"YOUR-API-KEY"];
[sdk reverseGeocodeWithLatitude:@(51.5159) longitude:@(0.1297) withAnnotations:YES completionBlock:^(OCGeoResponse * _Nonnull response, BOOL success, NSError * _Nullable error) {
    if (success) {
        // Successful payload response
    }
}];

正向地理编码是通过以下方法完成的，请求中的任何错误都在 completionBlock 的 'error' 中处理。服务器响应被解析成对象，以便易于访问。

let ocSDK :OCSDK = OCSDK(apiKey: "YOUR-API-KEY")
ocSDK.forwardGeocode(address: "3 Walls Court, Tewkesbury, England", withAnnotations: true) { (response, success, error) in
	if success {
		//Successful payload response
	}
}

OCSDK *sdk = [[OCSDK alloc] initWithApiKey:@"YOUR-API-KEY"];
[sdk forwardGeocodeWithAddress:@"3 Walls Court, Tewkesbury, England" withAnnotations:YES completionBlock:^(OCGeoResponse * _Nonnull response, BOOL success, NSError * _Nullable error) {
    if (success) {
        // Successful payload response
    }
}];

文档还包括 OCSDK.swift 文件中的内容。

许可证

此代码是根据 MIT 许可证的条款和条件发布的。