首页
/ Google Places API 使用指南

Google Places API 使用指南

2024-12-26 00:27:01作者:霍妲思

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. 项目安装方式

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

登录后查看全文
热门项目推荐