地点详情

请选择平台： Android iOS JavaScript 网络服务

Places SDK for iOS 可为您的应用提供丰富的信息 包括地点的名称和地址、地理位置 以纬度/经度坐标形式指定的位置、地点类型（例如 例如夜总会、宠物店、博物馆）等等。要访问 那么您可以使用地点 ID， 用于标识地点。

地点详情

通过 GMSPlace 类用于提供关于特定地点的信息。您可以拿到 GMSPlace 对象：

• 致电 GMSPlacesClient findPlaceLikelihoodsFromUserLocationWithPlaceFields:。请参阅 获取当前地点。
• 致电 GMSPlacesClient fetchPlaceFromPlaceID:，传递一个 GMSPlaceField、 地点 ID 和回调方法。对于“地点详情”请求，如果您没有 在请求中指定至少一个字段，或者如果您省略 fields 参数，系统将返回所有可能的字段，而您将 将产生相应的费用请参阅有关获取 按 ID 显示地点。

警告：如果您未在 或者，如果您在请求中省略 fields 参数，则所有可能的字段都将是 退货，您需要支付相应的费用。这仅适用于“地点” 详情请求。

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

由于地点数据结果不能为空，只能是地点 数据的结果（例如，如果请求的地点 则 photos 字段不会显示在结果中）。

以下示例传递了两个字段值的列表 指定请求返回的数据：

Swift

      // 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))
  

Objective-C

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

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

GMSPlaceFieldTakeout、GMSPlaceFieldDelivery、GMSPlaceFieldDineIn、GMSPlaceFieldCurbsidePickup、GMSPlaceFieldPhoneNumber、GMSPlaceFieldWebsite、 GMSPlaceFieldOpeningHours 和 GMSPlaceFieldAddressComponents 不支持 GMSPlaceLikelihoodList 地点对象。

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

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

• name - 地点的名称。
• editorialSummary - 提供地点的简单说明。
• placeID - 地点的文本标识符。已读 。
• 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。
• currentOpeningHours 和 secondaryOpeningHours - 用于休假和对地点的时间表进行临时更改的字段。

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

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

  • 地址组成部分的数组包含的组成部分可能多于 formattedAddress。
  • 该数组不一定包含 除了 formattedAddress。
  • 在两个时间点之间，响应格式不一定保持不变 请求。具体而言，addressComponents 的数量 会根据所请求的地址而变化， 同一地址组成部分在数组中的位置可能发生变化。 组成部分的类型也可能发生变化。特定组件可能 缺少某些信息。
• userRatingsTotal - 表示评价数量 对该地点的评分。

通过 GMSPlace 类包含以下成员函数：

• isOpen 用于计算地点在给定时间是否营业， 来自openingHours 和UTCOffsetMinutes， 以及当前日期和时间。
• isOpenAtDate 根据以下信息计算地点在给定日期是否营业 openingHours 和UTCOffsetMinutes， 以及当前日期和时间。

使用这些函数获取营业时间和/或日期时，原始的 fetchPlaceFromPlaceID: 或 findPlaceLikelihoodsFromUserLocationWithPlaceFields: 请求必须同时指定 GMSPlaceFieldOpeningHours 和 GMSPlaceFieldUTCOffsetMinutes 字段。如果缺少其中任何一个字段，生成的 GMSPlace 对象不会包含营业时间或日期，并且调用会返回 GMSPlaceOpenStatusUnknown。为了确保结果准确， GMSPlaceFieldBusinessStatus和GMSPlaceFieldUTCOffsetMinutes 字段。如果未要求，我们会认为 业务运营是否正常。

请观看此视频，了解如何使用 isOpen（含地点详情）。

获享超棒营业时间

虽然正常营业时间是通过 openingHours 获取的，但 currentOpeningHours 和 secondaryOpeningHours 支持节假日和临时时间表变更。 您可以过滤和显示这些特殊日子的特殊营业时间（如果有）。

Swift

    func examineOpeningHours(place: GMSPlace) {

      // Check if the current opening hours contains a special day that has exceptional hours
      guard let currentOpeningHours = place.currentOpeningHours else { return }
      if let specialDays = currentOpeningHours.specialDays {
        guard !specialDays.isEmpty else { return }
        if let specialDay = specialDays.filter { $0.isExceptional }.first  {
          // Indicate exceptional hours
        }
      }

      // Check if current opening hours contains a truncated time period
      let periods = currentOpeningHours.periods

      if !periods.isEmpty {
        for period in periods {
          let open = period.open
          let close = period.close

          if let open = open {
            let date = open.date

            if open.isTruncated {
              // Indicate truncated time period
            }
          }
        }
      }

      // Check if the place's secondary opening hours indicate when delivery is available
      let secondaryOpeningHours = place.secondaryOpeningHours
      guard let hoursType = secondaryOpeningHours.first?.hoursType else {
      return
      }

      if (hoursType == GMSPlaceHoursTypeDelivery) {
        // Indicate hours where delivery is available
      }
  }

Objective-C

- (void)examineOpeningHours:(GMSPlace *) place {

    // Check if the current opening hours contains a special day that has exceptional hours
    GMSOpeningHours *currentOpeningHours = place.currentOpeningHours;
    if (currentOpeningHours != nil) {
      NSArray<GMSPlaceSpecialDay *> *specialDays = currentOpeningHours.specialDays;
      if ([specialDays count] != 0) {
        for (GMSPlaceSpecialDay *specialDay in specialDays) {
          NSDate *date = specialDay.date;
          if ([specialDay isExceptional]) {
            // Indicate exceptional hours
          }
        }
      }
    }

    // Check if current opening hours contains a truncated time period
    NSArray <GMSPeriod *> * periods = currentOpeningHours.periods;

    if ([periods count] != 0) {
      for (GMSPeriod * period in periods) {
        GMSTimeOfWeek *open = period.open;
        GMSTimeOfWeek *close = period.close;

        if (open) {
          if ([open isTruncated]) {
            // Indicate truncated time period
          }
        }
      }
    }

    // Check if the place's secondary opening hours indicate when delivery is available
    GMSOpeningHours *secondaryOpeningHours = place.secondaryOpeningHours;
    GMSPlaceHoursType hoursType = secondaryOpeningHours.getHoursType;

    if (hoursType == GMSPlaceHoursTypeDelivery) {
      // Indicate hours where delivery is available
    }
}

按 ID 获取地点

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

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

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

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

Swift

// 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)")
  }
})

Objective-C

// 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 概览。