Google Places API 使用指南

1. 安装指南

在开始使用Google Places API之前，您需要先获取一个API密钥，并安装相应的Ruby gem包。

获取API密钥

访问Google Places API密钥申请页面，按照指示申请API密钥。

安装gem包

使用以下命令安装google_places gem包：

gem install google_places

或者，将以下代码添加到您的Gemfile中：

gem 'google_places'

然后执行bundle install命令。

2. 项目使用说明

本项目为Google Places API的Ruby封装，提供了对API的便捷访问。

创建客户端

在调用API之前，您需要创建一个GooglePlaces::Client实例，并传入您的API密钥：

@client = GooglePlaces::Client.new(API_KEY)

搜索地点

您可以通过多种方式搜索地点：

• 通过坐标搜索：

@client.spots(lat, lng)

• 指定地点类型：

@client.spots(lat, lng, types: 'restaurant')

• 通过地点名称搜索：

@client.spots(lat, lng, name: 'italian')

• 使用查询字符串搜索：

@client.spots_by_query('Pizza near Miami Florida')

• 获取地点详细信息：

@client.spot('CmRYAAA...upoTH3g')

注意事项

• 使用detail: true选项时，API会对每个地点额外发起一次请求以获取完整信息，这可能会对您的请求配额产生影响。
• reference字段在不同搜索间可能不同，因此请谨慎使用。

3. 项目API使用文档

以下为本项目提供的主要API方法：

• spots(lat, lng, [options]): 根据坐标搜索地点。
• spots_by_query(query, [options]): 根据查询字符串搜索地点。
• spot(place_id, [fields]): 根据地点ID获取地点详细信息。

options参数可以包括：

• :types: 地点类型，可以是单一类型或数组。
• :exclude: 要排除的类型，可以是单一类型或数组。
• :name: 地点名称。
• :radius: 搜索半径（单位：米）。
• :language: 返回的语言。
• :detail: 是否获取详细信息。

4. 项目安装方式

请参考“安装指南”部分中的步骤进行安装。