选择您的 API 版本

Places API 支持两个 API 版本： Places API 是 现有 API 和 Places API （新）是下一个 API 的世代版本。

随着 Places API（新）的发布，您的第一项任务是决定 一组 API。如果您是新客户或现有客户， 已在使用相应 API 的客户使用本指南了解密钥 两个 API 之间的差异。

API 列表

下表列出了这两组 API。如果您是现有客户， 使用此表确定用于替换您当前使用的 API 的新 API 资源。

Places API Places API（新） 备注
查找地点 文本搜索（新） 没有新版本的查找地点。 文本搜索（新）已将其取代。
附近搜索 附近搜索（新） 所有使用现有 API 且包含文本查询的请求都应使用 文本搜索（新） 因为“附近搜索（新）”不支持文本输入。
文本搜索 文本搜索（新）
地点详情 地点详情（新）
地点照片 地点照片（新）
地点自动填充 自动补全（新）
查询自动补全 自动补全（新） 自动补全功能中添加了一些功能（新增）

您启用的 Places API 服务的版本 控制应用使用的 API：

  • Places API：启用现有的 API。如果仅 已为以下项目启用 Places API： 您的应用使用的 API 密钥，则您的应用将无法访问新 API。

  • Places API（新）：启用所有新的 API 和 如重要功能添加到 Places SDK for iOS（新）。您的应用不会 对现有 API 的访问权限。

  • 二者皆可：同时为二者启用所有功能和 API Places SDK for iOS（新）和 Places SDK for iOS。

如需详细了解如何选择 Places API 服务， 请参阅设置您的 Google Cloud 项目。

迁移到新 API

如果您使用的是现有 API 并想迁移至新 API，请参阅 以下迁移指南：

向 Places API 添加的主要功能（新）

本部分介绍了 Places API（新）中添加的主要功能。

在 Google Cloud 标准平台上实现

Places API（新）是在 服务基础架构 。这种实施方式使其更安全、更可靠 提供增强的安全选项，例如 OAuth。这个标准 API 设计可实现不同 API 之间的一定程度的一致性，从而提高效率 使用 Places API（新）进行开发。

性能改进

Places API（新）改进了性能， 因此值得替换那些使用现有 Places API 的应用。

简化的价格方案

Places API（新）简化了定价流程，因此 为使用的流量付费。使用 字段掩码。

包含地点详情（新）、 附近搜索（新）和 文本搜索（新）可使用字段掩码来控制 要在响应中返回的字段列表。然后，您只需为数据付费 请求。使用字段遮盖是一种很好的设计做法 不会请求不必要的数据，这有助于避免不必要的处理时间 和结算费用。

地点的一致响应数据

使用现有的 API 时，地点详情、 附近搜索和文本搜索 API 针对地点返回了不同的响应数据。Places API（新） 对响应进行标准化，以便这些 API 针对一个地点都返回相同的数据。

展开的地点类型

现在，API 响应可包含地点的主要类型。每个地点都可以有 一个被指定为地点主要类型的类型值，如 表 A.

此外，新 API 还会添加下表所示的地点类型。您可以 在包含 附近搜索（新）和 文本搜索（新）。新类型全部包含在 表 A.

类型
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant 农场 korean_restaurant sporting_goods_store
barber_shop Farmstay lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal 市场 steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant 裁缝
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant 汽车旅店 thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
顾问 直升飞机场 游乐场 vegetarian_restaurant
convention_center hiking_area 学龄前儿童 vietnamese_restaurant
小屋 historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center 招待所 resort_hotel 批发商
dental_clinic hotel rest_stop

除了这些新类型之外，Places API（新）还迁移了以下类型 从表 2（适用于 Places API）到表 A（适用于 Places API） 也就是说，您现在可以将这些类型 搜索：

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

动态地点数据

Places API（新）支持动态响应数据，例如 或加油站的最新燃油价格。使用 这些响应字段来打造动态的用户体验。

您应选择哪个 API？

在开始应用开发之前，您必须选择 API：

  1. 如果您是刚开始使用 Places API 的新客户， 然后再从新 API 开始

  2. 如果您是新客户，且尚未有替代应用 例如地点自动补全或查询 自动补全，然后您可以组合使用新 API 和现有 API。

  3. 如果您是现有客户，可以继续使用现有的 API。不过，要充分利用性能改进和 增强了 Places API（新）的功能，您可以迁移到 新 API。

    有关迁移的详细信息，请参阅迁移 概览。