地点详情

Places SDK for iOS 可为您的应用提供有关地点的丰富信息，包括地点的名称和地址、以纬度/经度坐标指定的地理位置、地点类型（如夜总会、宠物店、博物馆）等。如需访问特定地点的此类信息，您可以使用地点 ID，即能够唯一标识地点的稳定标识符。

地点详情

GMSPlace 类可提供有关特定地点的信息。您可以通过以下方式获取 GMSPlace 对象：

• 调用 GMSPlacesClient findPlaceLikelihoodsFromUserLocationWithPlaceFields:。请参阅有关获取当前地点的指南。
• 调用 GMSPlacesClient fetchPlaceFromPlaceID:，并传递 GMSPlaceField、地点 ID 和回调方法。对于“地点详情”请求，如果您没有在请求中指定至少一个字段，或在请求中忽略了 fields 参数，系统将返回所有可能的字段，并根据情况计费。请参阅按 ID 获取地点指南。

请求地点时，您必须指定要返回哪些类型的地点数据。为此，请传递 GMSPlaceField 并指定要返回的数据类型。这是一项重要的考虑因素，因为这会影响每个请求的费用。

由于地点数据结果不得为空，因此系统只会返回包含数据的地点结果（例如，如果请求的地点没有照片，photos 字段将不会显示在结果中）。

以下示例会传递一个包含两个字段值的列表，以指定请求返回的数据：

      // A hotel in Saigon with an attribution.
      let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

      // Specify the place data types to return.
      let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
      UInt(GMSPlaceField.placeID.rawValue))!
  

      // A hotel in Saigon with an attribution.
      NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

      // Specify the place data types to return.
      GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);
  

详细了解地点字段。如需详细了解地点数据请求的结算方式，请参阅用量和结算。

GMSPlace 类可包含以下地点数据：

• name - 地点的名称。
• placeID - 地点的文本标识符。如需详细了解地点 ID，请参阅本页面的其余部分。
• coordinate - 地点的地理位置，由纬度和经度坐标指定。
• phoneNumber - 地点的电话号码（国际格式）。
• formattedAddress - 此位置直观易懂的地址。

  此地址通常相当于邮政地址。请注意，由于许可限制，某些国家/地区（例如英国）不允许发布真实的邮政地址。

  设有格式的地址在逻辑上包含一个或多个地址组成部分。例如，地址“111 8th Avenue, New York, NY”包含以下组成部分：“111”（门牌号）、“8th Avenue”（道路名称）、“New York”（城市）和“NY”（美国州名）。

  请勿以程序化方式解析设有格式的地址。您应改用单独的地址组成部分，API 响应除了包含设有格式的地址字段外，还包含这些组成部分。

• openingHours - 地点的营业时间（用 GMSOpeningHours 表示）。调用 GMSOpeningHours.weekdayText 以获取一周中每日营业时间的本地化字符串列表。调用 GMSOpeningHours.Periods 会返回 GMSPeriod 列表，其中包含更详细的信息，等同于 weekdayText 提供的数据。注意：如果某个地点一直营业，则时间段会显示为星期日的午夜，且 closeEvent 为 null。

• addressComponents - 一个 GMSAddressComponent 对象数组，代表地点的地址组成部分。提供这些组件的目的是提取有关地点地址的结构化信息，例如查找地点所在的城市。请勿使用这些组件进行地址格式设置；请改用 formattedAddress 属性，此属性可以提供本地化格式的地址。

  请注意关于 addressComponents 数组的以下事实：

  • 地址组成部分的数组包含的组成部分可能多于 formattedAddress。
  • 该数组不一定包含 formattedAddress 中包含的所有地址的政治实体。
  • 两次请求之间的响应格式不一定相同。特别是，addressComponents 的数量因所请求的地址而异，对于同一个地址，数量也可能会随着时间推移而发生变化。组件可以更改在数组中的位置。组成部分的类型也可能发生变化。后续响应中可能缺少特定组件。
• userRatingsTotal - 表示地点评分中包含的评价数量。

GMSPlace 类包含以下成员函数：

• isOpen 会根据 openingHours 和 UTCOffsetMinutes 以及当前的日期和时间，计算地点在给定时间是否营业。
• isOpenAtDate 会根据 openingHours 和 UTCOffsetMinutes 以及当前日期和时间，计算地点在指定日期是否开始营业。

使用这些函数获取营业时间和/或日期时，原始 fetchPlaceFromPlaceID: 或 findPlaceLikelihoodsFromUserLocationWithPlaceFields: 请求必须同时指定 GMSPlaceFieldOpeningHours 和 GMSPlaceFieldUTCOffsetMinutes 字段。如果缺少其中任何一个字段，生成的 GMSPlace 对象将不包含打开时间或日期，并且调用将返回 GMSPlaceOpenStatusUnknown。为确保结果准确，请请求原始地点请求中的 GMSPlaceFieldBusinessStatus 和 GMSPlaceFieldUTCOffsetMinutes 字段。如果未请求，系统会假定商家在运营。

如需了解如何将 isOpen 与地点详情结合使用，请观看此视频。

按 ID 获取地点

地点 ID 是唯一标识地点的文本标识符。在 Places SDK for iOS 中，您可以从 GMSPlace 对象中检索地点 ID。您可以存储地点 ID，稍后再用它来检索 GMSPlace 对象。

如需按 ID 获取地点，请调用 GMSPlacesClient fetchPlaceFromPlaceID:，并传递以下参数：

• 包含地点 ID 的字符串。
• 一个或多个 GMSPlaceField，指定要返回的数据类型。
• 一个会话令牌（如果调用以结束自动补全查询）。 否则，传递 nil。
• 用于处理结果的 GMSPlaceResultCallback。

API 调用指定的回调方法，传入 GMSPlace 对象。如果未找到地点，则地点对象为零值。

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.name.rawValue) |
  UInt(GMSPlaceField.placeID.rawValue))!

placesClient?.fetchPlace(fromPlaceID: placeID, placeFields: fields, sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    self.lblName?.text = place.name
    print("The selected place is: \(place.name)")
  }
})

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return.
GMSPlaceField fields = (GMSPlaceFieldName | GMSPlaceFieldPlaceID);

[_placesClient fetchPlaceFromPlaceID:placeID placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    NSLog(@"The selected place is: %@", [place name]);
  }
}];

在应用中显示提供方说明

当您的应用显示从 GMSPlacesClient lookUpPlaceID:callback: 获取的信息时，它还必须显示提供方说明。请参阅有关归因的文档。

更多关于地点 ID 的内容

Places SDK for iOS 中使用的地点 ID 与 Places API、Places SDK for Android 和其他 Google API 中使用的标识符相同。

每个地点 ID 只能引用一个地点，但单个地点可以有多个地点 ID。

在某些情况下，地点可能会获得新的地点 ID。例如，如果商家搬到新位置，会获取新的地点 ID。

通过指定地点 ID 请求地点时，您可以确信始终会在响应中收到相同的地点（如果该地点仍然存在）。但请注意，响应中包含的地点 ID 可能与您请求中的地点 ID 不同。

如需了解详情，请参阅地点 ID 概览。