GPlaceAPI 是一个开源的 iOS Objective-C 库，用于通过简单的基于块的 API 回调调用获取 Google Places API。

其主要目的是在更少的代码行中使用 Google Places API 请求。

这包括以下内容：

• 地点搜索
  • 周边搜索（在指定区域内搜索地点）
  • 文本搜索（根据搜索字符串搜索地点）
• 地点详情（获取有关地点的更多信息）
• 地点自动补全（根据搜索文本获取地点预测）
• 查询自动补全（获取动态地理查询预测）

如何使用

手动（或使用 git submodule）

1. 实现 AFNetworking 2.0
   • GPlaceAPI 使用 AFNetworking 2.0，因此你需要将 AFNetworking 添加到你的项目
2. 从此存储库下载源文件
3. 将 GPlaceAPI 文件夹中的所有文件添加到你的项目的目标中

使用方法

你可以查看详细的示例使用项目 GPlaceAPIExample/GPlaceAPIExample.xcodeproj。

1. 在实现文件中导入 GPlaceAPI 文件

#import "GPHeader.h"

2. 设置 Google 地点 API 密钥

为了与 Google 地点 API 进行通信，你必须首先生成自己的 API 密钥。请参阅 介绍 - Google 地点 API。

在使用 GPlaceAPI 之前，你必须提供 API 密钥。

//打开 "AppDelegate.h" 并设置你的 API_KEY

[[GPlaceAPISetup sharedInstance] setApi_Key:@"SET_API_KEY"];

3. 发送请求 & 获取响应

 CLLocationCoordinate2D location = CLLocationCoordinate2DMake(51.501103,-0.124565);
 GPPlaceSearchRequest *request =[[GPPlaceSearchRequest alloc] initWithLocationCoordinate:location];
 request.radius = 5000;
 [request doFetchPlaces:^(GPPlaceSearchResponse *response, NSError *error) {
        if(!error){
            if(response.status ==  GPRequestStatusOK) {
                // Access place results by below model
                GPResult *result =response.results[0];
                NSLog(@"%@",result.name);
            }
       } 
    }];

请参阅 Google 地点 API 文档 以获取请求和响应。你可以在 Google 地点 API 文档 中搜索所有请求参数并获取所有提及的对象的响应。

兼容性

• iOS 7.0+

待办事项

• 添加如何使用此库的示例项目。
• 为这个库编写测试用例。

联系

GPlaceAPI由Darshan Patel开发。请通过电子邮件告诉我您是如何使用这个库的以及与此相关的任何内容。

贡献和注意事项

• 如果您喜欢这个库，请考虑给它一个GitHub star。

非常欢迎Pull请求，但请遵循以下几条规则

• 请在代码注释和Git提交信息中对您的更改进行文档说明
• 请确保您的更改不会影响任何现有代码

版本历史

1.0 初始预发布

• 添加了第一个版本。

1.0.1 预发布

• 简化了添加API_key的方式
• 修复了价格级别的枚举错误

2.0 公开 - 发布

• 在GPPhoto类中添加了photo_url

2.0.2 公开 - 发布

• 移除了整数转换的警告

许可证

MIT许可证（MIT）

版权所有（c）2015 Darshan Patel

特此授予取得此软件和所附相关文档（“软件”）副本的任何个人免费使用权，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许提供软件的个人使用上述软件，但必须遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“现状”提供，不提供任何形式的明示或暗示保证，包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论该责任是基于合同、侵权或其他，源自、由于或有关于软件或软件的使用或其他事务。