Di chuyển đến thông tin chi tiết về địa điểm (Mới)

Places SDK for iOS hỗ trợ Thông tin chi tiết về địa điểm (Phiên bản cũ). Nếu bạn đã quen thuộc với Places SDK for iOS (Phiên bản cũ), Thông tin chi tiết về địa điểm (Mới) sẽ thực hiện những thay đổi sau:

  • Sử dụng mô hình định giá mới. Để biết thông tin về giá của tất cả các API, hãy xem Giá của Places SDK cho iOS (Mới).

  • Bạn phải che trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong phản hồi. Không có danh sách mặc định về các trường được trả về. Nếu bạn bỏ qua danh sách này, các phương thức sẽ trả về lỗi.

  • Để đưa ra yêu cầu, hãy gọi phương thức GMSPlacesClient fetchPlaceWithRequest: mới.

  • Truyền đến yêu cầu:

    • Một thực thể của lớp GMSFetchPlaceRequest mới xác định tất cả các tham số yêu cầu, chẳng hạn như mã địa điểm và mã thông báo phiên.

    • Một lệnh gọi lại thuộc loại GMSPlaceResultCallback để xử lý phản hồi.

  • Phản hồi chứa một thực thể GMSPlace chứa thông tin chi tiết về địa điểm. Các giá trị trong thuộc tính types của thực thể GMSPlace hiện được xác định bằng Bảng A và Bảng B.

  • Đối tượng GMSPlace phản hồi chứa thuộc tính reviews mới thuộc loại GMSPlaceReview. Khi ứng dụng của bạn hiển thị thông tin thu được từ phiên bản GMSPlace, chẳng hạn như ảnh và bài đánh giá, ứng dụng cũng phải hiển thị thông tin ghi nhận quyền tác giả bắt buộc.

    Để biết thêm thông tin, hãy xem tài liệu về phân bổ.

  • Đối tượng GMSPlace phản hồi chứa các hàm thành viên sau:

    • isOpentính toán xem một địa điểm có mở cửa vào thời gian đã cho hay không.

    • isOpenAtDate tính toán xem một địa điểm có mở cửa vào một ngày cụ thể hay không.

    Các hàm này chỉ có khi bạn bật Places SDK cho iOS. Các lớp này không có sẵn khi bạn bật Places SDK for iOS (Mới). Để biết thêm thông tin, hãy xem phần Chọn phiên bản SDK.

Ví dụ về yêu cầu

Với Place Details (New), bạn đưa ra yêu cầu và truyền tất cả các thông số trong thực thể GMSFetchPlaceRequest. Ví dụ này cũng sử dụng một mặt nạ trường để phản hồi chỉ bao gồm tên hiển thị và URL trang web cho địa điểm:

Swift

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

// Specify the place data types to return.
let fields = [GMSPlaceProperty.name, GMSPlaceProperty.website].map {$0.rawValue}

// Create the GMSFetchPlaceRequest instance.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: fields, sessionToken: nil)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  guard let place, error == nil else { return }
  print("Place found: \(String(describing: place.name))")
})

Objective-C

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

// Specify the place data types to return.
NSArray<NSString *> *fields = @[GMSPlacePropertyName, GMSPlacePropertyWebsite];

// Create the GMSFetchPlaceRequest instance.
GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: fields sessionToken:nil];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
    if (error != nil) {
      NSLog(@"An error occurred %@", [error localizedDescription]);
      return;
    } else {
    NSLog(@"Place Found: %@", place.name);
    NSLog(@"The place URL: %@", place.website);
  }
}];