Trang này được dịch bởi Cloud Translation API.

Chi tiết địa điểm (Mới)

Chọn nền tảng: Android iOS JavaScript Dịch vụ web

SDK Địa điểm cho iOS (Mới) cung cấp cho ứng dụng của bạn thông tin phong phú về các địa điểm, bao gồm tên và địa chỉ của địa điểm, vị trí địa lý được chỉ định dưới dạng toạ độ vĩ độ/kinh độ, loại địa điểm (chẳng hạn như câu lạc bộ đêm, cửa hàng thú cưng, bảo tàng), v.v. Để truy cập thông tin này cho một địa điểm cụ thể, bạn có thể sử dụng mã địa điểm, một giá trị nhận dạng ổn định giúp xác định duy nhất một địa điểm.

Nhận thông tin chi tiết về địa điểm

Lớp GMSPlace chứa thông tin về một địa điểm cụ thể, bao gồm tất cả các trường dữ liệu hiển thị trong Trường dữ liệu địa điểm (Mới). Lấy đối tượng GMSPlace bằng cách gọi GMSPlacesClient fetchPlaceWithRequest:, truyền đối tượng GMSFetchPlaceRequest và phương thức gọi lại thuộc loại GMSPlaceResultCallback.

Đối tượng GMSFetchPlaceRequest chỉ định:

(Bắt buộc) Mã địa điểm, giá trị nhận dạng duy nhất cho một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps.
(Bắt buộc) Danh sách các trường cần trả về trong đối tượng GMSPlace, còn gọi là mặt nạ trường, do GMSPlaceProperty xác định. Nếu bạn không chỉ định ít nhất một trường trong danh sách trường hoặc nếu bạn bỏ qua danh sách trường, thì lệnh gọi sẽ trả về lỗi.
(Không bắt buộc) Mã vùng dùng để định dạng câu trả lời.
(Không bắt buộc) Mã thông báo phiên dùng để kết thúc phiên Tự động điền (Mới).

Đưa ra yêu cầu về Chi tiết địa điểm

Ví dụ này lấy một địa điểm theo mã nhận dạng, truyền các tham số sau:

Mã địa điểm của ChIJV4k8_9UodTERU5KXbkYpSYs.
Danh sách trường chỉ định trả về tên địa điểm và URL của trang web.
GMSPlaceResultCallback để xử lý kết quả.

API gọi phương thức gọi lại đã chỉ định, truyền vào một đối tượng GMSPlace. Nếu không tìm thấy địa điểm, đối tượng địa điểm sẽ rỗng.

Swift

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

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

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

client.fetchPlace(with: 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 *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite];

// Create the GMSFetchPlaceRequest object.
GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties 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);
  }
}];

SDK Swift của Địa điểm dành cho iOS (Bản dùng thử)

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"
let fetchPlaceRequest = FetchPlaceRequest(
  placeID: placeID,
  placeProperties: [.name, .website]
)
switch await placesClient.fetchPlace(with: fetchPlaceRequest) {
case .success(let place):
  // Handle place
case .failure(let placesError):
  // Handle error
}

Phản hồi về Thông tin chi tiết về địa điểm

Thông tin chi tiết về địa điểm trả về một đối tượng GMSPlace chứa thông tin chi tiết về địa điểm đó. Chỉ những trường được chỉ định trong danh sách trường mới được điền vào đối tượng GMSPlace.

Lưu ý: Các trường của đối tượng GMSPlace phản hồi không được để trống. Ví dụ: nếu danh sách trường bao gồm GMSPlacePropertyPhotos để yêu cầu trường photos trong phản hồi và trường photos trong phản hồi trống, thì trường này sẽ bị bỏ qua khỏi đối tượng GMSPlace phản hồi.

Lấy trạng thái đang mở

Đối tượng GMSPlacesClient chứa một hàm thành viên có tên là isOpenWithRequest (isOpenRequest trong Swift và isPlaceOpenRequest trong GooglePlacesSwift) trả về phản hồi cho biết liệu địa điểm đó có đang mở cửa hay không, dựa trên thời gian được chỉ định trong lệnh gọi.

Lưu ý: Các hàm GMSPlace isOpen: và GMSPlace isOpenAtDate: không dùng nữa có thể không chính xác và không được dùng với API Địa điểm (Mới).

Phương thức này nhận một đối số duy nhất thuộc loại GMSPlaceIsOpenWithRequest chứa:

Một đối tượng GMSPlace hoặc một chuỗi chỉ định mã địa điểm. Để biết thêm thông tin về cách tạo đối tượng Địa điểm bằng các trường cần thiết, hãy xem phần Thông tin chi tiết về địa điểm.

Lưu ý: Đối tượng Địa điểm phải chứa mã địa điểm hợp lệ.
Một đối tượng NSDate (Obj-C) hoặc Date (Swift) không bắt buộc, chỉ định thời gian bạn muốn kiểm tra. Nếu bạn không chỉ định thời gian, thời gian mặc định sẽ là hiện tại.
Phương thức GMSPlaceOpenStatusResponseCallback để xử lý phản hồi.

Phương thức GMSPlaceIsOpenWithRequest yêu cầu bạn phải đặt các trường sau trong đối tượng GMSPlace:

GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyBusinessStatus
GMSPlacePropertyOpeningHours
GMSPlacePropertyCurrentOpeningHours
GMSPlacePropertySecondaryOpeningHours

Nếu các trường này không được cung cấp trong đối tượng Địa điểm hoặc nếu bạn truyền mã địa điểm, thì phương thức này sẽ sử dụng GMSPlacesClient GMSFetchPlaceRequest: để tìm nạp các trường đó.

Phản hồi `isOpenWithRequest`

isOpenWithRequest trả về một đối tượng GMSPlaceIsOpenResponse chứa giá trị boolean có tên status cho biết doanh nghiệp đang mở cửa, đóng cửa hay trạng thái không xác định.

Ngôn ngữ	Giá trị nếu mở	Giá trị nếu đóng	Giá trị nếu trạng thái không xác định
Swift	`.open`	`.closed`	`.unknown`
Objective-C	`GMSPlaceOpenStatusOpen`	`GMSPlaceOpenStatusClosed`	`GMSPlaceOpenStatusUnknown`
GooglePlacesSwift (Bản xem trước)	`true`	`false`	`nil`

Thông tin thanh toán cho `isOpenWithRequest`

Các trường GMSPlacePropertyUTCOffsetMinutes và GMSPlacePropertyBusinessStatus được tính phí theo SKU Dữ liệu cơ bản. Phần còn lại của Giờ mở cửa sẽ được tính phí theo SKU Thông tin chi tiết về địa điểm (Nâng cao).
Nếu đối tượng GMSPlace đã có các trường này từ một yêu cầu trước đó, bạn sẽ không bị tính phí lại.
Cảnh báo Nếu đối tượng GMSPlace của bạn không có các trường này, bạn sẽ bị tính phí lại cho SKU Dữ liệu cơ bản. Phần còn lại của Giờ mở cửa sẽ được tính phí theo SKU Thông tin chi tiết về địa điểm (Nâng cao). Nếu dự án của bạn sẽ sử dụng isOpenWithRequest, bạn nên đảm bảo rằng bạn tìm nạp thông tin chi tiết cần thiết về địa điểm.

Ví dụ: Tạo yêu cầu `GMSPlaceIsOpenWithRequest`

Ví dụ sau đây cho thấy cách khởi chạy GMSPlaceIsOpenWithRequest trong một đối tượng GMSPlace hiện có.

Swift

    let isOpenRequest = GMSPlaceIsOpenRequest(place: place, date: nil)
      GMSPlacesClient.shared().isOpen(with: isOpenRequest) { response, error in
        if let error = error {
          // Handle Error
        }
        switch response.status {
          case .open:
            // Handle open
          case .closed:
            // Handle closed
          case .unknown:
            // Handle unknown
        }
      }

Objective-C

          GMSPlaceIsOpenRequest *isOpenRequest = [[GMSPlaceIsOpenRequest alloc] initWithPlace:place date:nil];
  
          [[GMSPlacesClient sharedClient] isOpenWithRequest:isOpenRequest callback:^(GMSPlaceIsOpenResponse response, NSError *_Nullable error) {
            if (error) {
              // Handle error
            }
  
            switch (response.status) {
              case GMSPlaceOpenStatusOpen:
                // Handle open
              case GMSPlaceOpenStatusClosed:
                // Handle closed
              case GMSPlaceOpenStatusUnknown:
                // Handle unknown
            }
          }];

GooglePlacesSwift

          let isOpenRequest = IsPlaceOpenRequest(place: place)
          switch await placesClient.isPlaceOpen(with: isOpenRequest) {
            case .success(let isOpenResponse):
              switch isOpenResponse.status {
                case true:
                  // Handle open
                case false:
                  // Handle closed
                case nil:
                  // Handle unknown
            case .failure(let placesError):
              // Handle error
          }

Thông số bắt buộc

Sử dụng đối tượng GMSFetchPlaceRequest để chỉ định các tham số bắt buộc.

Mã địa điểm

Mã địa điểm dùng trong SDK Địa điểm dành cho iOS là giá trị nhận dạng giống như dùng trong API Địa điểm, SDK Địa điểm dành cho Android và các API khác của Google. Mỗi mã địa điểm chỉ có thể tham chiếu đến một địa điểm, nhưng một địa điểm có thể có nhiều mã địa điểm.

Có một số trường hợp có thể khiến một địa điểm nhận được mã địa điểm mới. Ví dụ: điều này có thể xảy ra nếu một doanh nghiệp chuyển đến một địa điểm mới.

Khi yêu cầu một địa điểm bằng cách chỉ định mã địa điểm, bạn có thể yên tâm rằng mình sẽ luôn nhận được cùng một địa điểm trong phản hồi (nếu địa điểm đó vẫn tồn tại). Tuy nhiên, xin lưu ý rằng phản hồi có thể chứa mã địa điểm khác với mã địa điểm trong yêu cầu của bạn.

Danh sách trường

Khi yêu cầu thông tin chi tiết về địa điểm, bạn phải chỉ định dữ liệu cần trả về trong đối tượng GMSPlace cho địa điểm dưới dạng mặt nạ trường. Để xác định mặt nạ trường, hãy truyền một mảng giá trị từ GMSPlaceProperty đến đối tượng GMSFetchPlaceRequest. Việc che trường là một phương pháp thiết kế hay để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và phí thanh toán không cần thiết.

Chỉ định một hoặc nhiều trường sau:

Các trường sau đây sẽ kích hoạt SKU Chi tiết địa điểm (chỉ mã nhận dạng):

GMSPlacePropertyPlaceID, GMSPlacePropertyName, GMSPlacePropertyPhotos
Các trường sau đây sẽ kích hoạt SKU Thông tin chi tiết về địa điểm (Chỉ vị trí):

GMSPlacePropertyAddressComponents, GMSPlacePropertyFormattedAddress, GMSPlacePropertyCoordinate, GMSPlacePropertyPlusCode, GMSPlacePropertyTypes, GMSPlacePropertyViewport
Các trường sau đây sẽ kích hoạt SKU Thông tin chi tiết về địa điểm (Cơ bản):

GMSPlacePropertyBusinessStatus, GMSPlacePropertyIconBackgroundColor, GMSPlacePropertyIconImageURL, GMSPlacePropertyUTCOffsetMinutes, GMSPlacePropertyWheelchairAccessibleEntrance
Các trường sau đây sẽ kích hoạt SKU Chi tiết địa điểm (Nâng cao):

GMSPlacePropertyCurrentOpeningHours, GMSPlacePropertySecondaryOpeningHours, GMSPlacePropertyPhoneNumber, GMSPlacePropertyPriceLevel, GMSPlacePropertyRating, GMSPlacePropertyOpeningHours, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyWebsite
Các trường sau đây sẽ kích hoạt SKU Chi tiết địa điểm (Ưu tiên):

GMSPlacePropertyCurbsidePickup, GMSPlacePropertyDelivery, GMSPlacePropertyDineIn, GMSPlacePropertyEditorialSummary, GMSPlacePropertyReservable, GMSPlacePropertyReviews, GMSPlacePropertyServesBeer, GMSPlacePropertyServesBreakfast, GMSPlacePropertyServesBrunch, GMSPlacePropertyServesDinner, GMSPlacePropertyServesLunch, GMSPlacePropertyServesVegetarianFood, GMSPlacePropertyServesWine, GMSPlacePropertyTakeout

Ví dụ sau đây truyền danh sách gồm hai giá trị trường để chỉ định rằng đối tượng GMSPlace do yêu cầu trả về chứa các trường name và placeID:

Swift

// Specify the place data types to return.
let fields: [GMSPlaceProperty] = [.placeID, .name]

Objective-C

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

SDK Swift của Địa điểm dành cho iOS (Bản dùng thử)

// Specify the place data types to return.
let fields: [PlaceProperty] = [.placeID, .displayName]

Thông số tùy chọn

Sử dụng đối tượng GMSFetchPlaceRequest để chỉ định các tham số không bắt buộc.

regionCode

Mã khu vực dùng để định dạng phản hồi, được chỉ định dưới dạng giá trị mã CLDR gồm hai ký tự. Tham số này cũng có thể gây ra hiệu ứng thiên vị đối với kết quả tìm kiếm. Không có giá trị mặc định.

Nếu tên quốc gia của trường địa chỉ trong phản hồi khớp với mã khu vực, thì mã quốc gia sẽ bị bỏ qua khỏi địa chỉ.

Hầu hết mã CLDR giống hệt với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Anh và Bắc Ireland"). Thông số này có thể ảnh hưởng đến kết quả dựa trên luật hiện hành.

sessionToken

Mã thông báo phiên là các chuỗi do người dùng tạo, theo dõi các lệnh gọi Tự động hoàn thành (Mới) dưới dạng "phiên". Tính năng Tự động hoàn thành (Mới) sử dụng mã thông báo phiên để nhóm các giai đoạn lựa chọn cụm từ tìm kiếm và vị trí của một lượt tìm kiếm tự động hoàn thành của người dùng vào một phiên riêng biệt cho mục đích thanh toán. Mã thông báo phiên được truyền vào các lệnh gọi Thông tin chi tiết về địa điểm (Mới) theo sau các lệnh gọi Tự động hoàn thành (Mới). Để biết thêm thông tin, hãy xem phần Mã thông báo phiên.

Hiển thị thông tin phân bổ trong ứng dụng

Khi ứng dụng của bạn hiển thị thông tin thu được từ GMSPlacesClient, chẳng hạn như ảnh và bài đánh giá, thì ứng dụng đó cũng phải hiển thị các thông tin ghi công bắt buộc.

Ví dụ: thuộc tính reviews của đối tượng GMSPlacesClient chứa một mảng gồm tối đa 5 đối tượng GMSPlaceReview. Mỗi đối tượng GMSPlaceReview có thể chứa các thuộc tính và thuộc tính tác giả. Nếu hiển thị bài đánh giá trong ứng dụng, thì bạn cũng phải hiển thị mọi thông tin ghi công hoặc thông tin ghi công tác giả.

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

Chi tiết địa điểm (Mới)

Nhận thông tin chi tiết về địa điểm

Đưa ra yêu cầu về Chi tiết địa điểm

Swift

Objective-C

SDK Swift của Địa điểm dành cho iOS (Bản dùng thử)

Phản hồi về Thông tin chi tiết về địa điểm

Lấy trạng thái đang mở

Phản hồi isOpenWithRequest

Thông tin thanh toán cho isOpenWithRequest

Ví dụ: Tạo yêu cầu GMSPlaceIsOpenWithRequest

Swift

Objective-C

GooglePlacesSwift

Thông số bắt buộc

Mã địa điểm

Danh sách trường

Swift

Objective-C

SDK Swift của Địa điểm dành cho iOS (Bản dùng thử)

Thông số tùy chọn

regionCode

sessionToken

Hiển thị thông tin phân bổ trong ứng dụng

Phản hồi `isOpenWithRequest`

Thông tin thanh toán cho `isOpenWithRequest`

Ví dụ: Tạo yêu cầu `GMSPlaceIsOpenWithRequest`