Tổng quan

Giao diện chính cho SDK Địa điểm.

Dùng để tìm kiếm và xem thông tin chi tiết về các địa điểm. Bạn nên truy cập vào lớp này thông qua phương thức [GMSPlacesClient sharedClient].

Bạn chỉ nên gọi các phương thức GMSPlacesClient từ luồng chính. Việc gọi các phương thức này từ một luồng khác sẽ dẫn đến một ngoại lệ hoặc hành vi không xác định. Trừ phi có quy định khác, tất cả lệnh gọi lại sẽ được gọi trên luồng chính.

Hàm thành viên công khai
(void)	– lookUpPlaceID:callback:
	Xem thông tin chi tiết về một địa điểm.
(void)	– lookUpPhotosForPlaceID:callback:
	Lấy siêu dữ liệu cho tối đa 10 ảnh liên kết với một địa điểm.
(void)	– loadPlacePhotos:callback:
	Tải hình ảnh cho một ảnh cụ thể ở kích thước tối đa.
(void)	– loadPlacePhoto:constrainedToSize:scale:callback:
	Tải hình ảnh cho một ảnh cụ thể, được điều chỉnh theo tỷ lệ cho vừa với kích thước tối đa nhất định.
(void)	– currentPlaceWithCallback:
	Trả về kết quả ước tính về vị trí hiện đã xác định được vị trí của thiết bị.
(void)	– findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Tìm cụm từ gợi ý Tự động hoàn thành qua truy vấn văn bản.
(void)	– fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	Tìm nạp thông tin chi tiết cho một địa điểm.
(void)	– findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Tìm các khả năng về địa điểm bằng cách sử dụng vị trí hiện tại của người dùng.
(void)	– isOpenWithPlaceID:callback:
	Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định `GMSPlaceOpenStatus` ở thời điểm hiện tại.
(void)	– isOpenWithPlaceID:date:callback:
	Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định `GMSPlaceOpenStatus` tại `NSDate` được chỉ định.
(void)	– isOpenWithPlace:callback:
	Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định `GMSPlaceOpenStatus` ở thời điểm hiện tại.
(void)	– isOpenWithPlace:date:callback:
	Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định `GMSPlaceOpenStatus` tại `NSDate` được chỉ định.
(void)	– searchByTextWithRequest:callback:
	Tìm địa điểm theo văn bản và các quy định hạn chế.
Hàm thành viên công khai tĩnh
(instancetype)	+ sharedClient
	Cung cấp phiên bản được chia sẻ của GMSPlacesClient cho SDK Google địa điểm dành cho iOS, tạo thực thể này nếu cần.
(BOOL)	+ provideAPIKey:
	Cung cấp khoá API cho SDK Google Địa điểm dành cho iOS.
(NSString *)	+ openSourceLicenseInfo
	Trả về thông tin giấy phép phần mềm nguồn mở cho SDK Google địa điểm dành cho iOS.
(NSString *)	+ SDKVersion (Phiên bản SDK)
	Trả về phiên bản của bản phát hành SDK Google địa điểm dành cho iOS này.
(NSString *)	+ SDKLongVersion
	Trả về phiên bản dài cho bản phát hành SDK Google Địa điểm dành cho iOS này.
Hàm liên quan
(Lưu ý rằng đây không phải là các hàm thành phần.)
typedef void(^	GMSPlaceResultCallback )(GMSPlace _Nullable kết quả, NSError _lỗi có thể có giá trị)
	Loại lệnh gọi lại để nhận nội dung tra cứu thông tin chi tiết về địa điểm.
typedef void(^	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Nullable receivedList, NSError _Nullable error)
	Loại lệnh gọi lại để nhận danh sách khả năng xử lý địa điểm.
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Nullable khả năng, NSError _Nullable error)
	Loại lệnh gọi lại để nhận mảng `GMSPlaceLikelihood`.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > _Nullable kết quả, NSError _Nullable error)
	Loại lệnh gọi lại để nhận kết quả tự động hoàn thành.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Nullable ảnh, NSError _Nullable error)
	Loại lệnh gọi lại để nhận kết quả hình ảnh địa điểm.
typedef void(^	GMSPlacePhotoImageResultCallback )(UIImage _Nullable ảnh, NSError _Nullable error)
	Loại lệnh gọi lại để nhận đối tượng `UIImage` từ đối tượng `GMSPlacePhotoMetadata`.
typedef void(^	GMSPlaceOpenStatusCallback )(kết quả GMSPlaceOpenStatus, NSError *_Nullable error)
	Loại lệnh gọi lại để nhận trạng thái giờ mở cửa cho Địa điểm.
typedef void(^	GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > _Nullable places, NSError _Nullable error)
	Loại lệnh gọi lại để nhận kết quả tìm kiếm bằng văn bản.

Tài liệu về hàm thành phần

+ (instancetype) sharedClient

Cung cấp phiên bản được chia sẻ của GMSPlacesClient cho SDK Google địa điểm dành cho iOS, tạo thực thể này nếu cần.

Nếu ứng dụng của bạn thường sử dụng các phương thức của GMSPlacesClient, thì ứng dụng nên trực tiếp giữ lại đối tượng này, nếu không thì kết nối của bạn với Google có thể được khởi động lại thường xuyên.

+ (BOOL) provideAPIKey: (NSString *) key

Cung cấp khoá API cho SDK Google Địa điểm dành cho iOS.

Khoá này được tạo cho ứng dụng của bạn thông qua Bảng điều khiển Google Cloud Platform và được ghép nối với mã nhận dạng gói của ứng dụng để xác định khoá đó. Ứng dụng của bạn sẽ gọi lệnh này trước khi sử dụng GMSPlacesClient (ví dụ: trong application:didFinishLaunchingWithOptions:).

Trường hợp trả lại hàng:: CÓ nếu bạn cung cấp thành công APIKey.

+ (NSString *) openSourceLicenseInfo

Trả về thông tin giấy phép phần mềm nguồn mở cho SDK Google địa điểm dành cho iOS.

Bạn phải cung cấp thông tin này trong đơn đăng ký.

+ (NSString *) SDKVersion

Trả về phiên bản của bản phát hành SDK Google địa điểm dành cho iOS này.

. Ví dụ: "1.0.0".

+ (NSString *) SDKLongVersion

Trả về phiên bản dài cho bản phát hành SDK Google Địa điểm dành cho iOS này.

. Ví dụ: "1.0.0 (102.1)".

– (vô hiệu) LookUpPlaceID:	(NSString *)	placeID
gọi lại:	(GMSPlaceResultCallback)	lệnh gọi lại

Xem thông tin chi tiết về một địa điểm.

Phương thức này không chặn.

Các tham số:

placeID	Mã địa điểm cần tra cứu.
số gọi lại	Lệnh gọi lại để gọi kết quả tra cứu.

– (vô hiệu) LookUpPhotosForPlaceID:	(NSString *)	placeID
gọi lại:	(GMSPlacePhotoMetadataResultCallback)	lệnh gọi lại

Lấy siêu dữ liệu cho tối đa 10 ảnh liên kết với một địa điểm.

Ảnh được lấy từ nhiều vị trí, bao gồm cả chủ doanh nghiệp và ảnh do người dùng Google+ đóng góp. Trong hầu hết các trường hợp, bạn có thể sử dụng những ảnh này mà không cần ghi công hoặc sẽ có thuộc tính bắt buộc trong hình ảnh. Tuy nhiên, bạn phải sử dụng thuộc tính attributions trong phản hồi để truy xuất mọi thuộc tính bổ sung cần thiết và hiển thị các thuộc tính đó trong ứng dụng của bạn ở bất cứ nơi nào hình ảnh xuất hiện. Bạn chỉ được trả lại tối đa 10 ảnh.

Nhiều lệnh gọi của phương thức này có thể sẽ trả về cùng một ảnh mỗi lần. Tuy nhiên, điều này không được đảm bảo vì dữ liệu cơ bản có thể đã thay đổi.

Phương thức này thực hiện quá trình tra cứu mạng.

Các tham số:

placeID	Mã địa điểm cần tra cứu ảnh.
số gọi lại	Lệnh gọi lại để gọi kết quả tra cứu.

- (vô hiệu) loadPlaceẢnh:	(GMSPlacePhotoMetadata *)	photoMetadata
gọi lại:	(GMSPlacePhotoImageResultCallback)	lệnh gọi lại

Tải hình ảnh cho một ảnh cụ thể ở kích thước tối đa.

SDK có thể lưu dữ liệu hình ảnh vào bộ nhớ đệm. Nếu ảnh được yêu cầu không tồn tại trong bộ nhớ đệm thì tra cứu mạng sẽ được thực hiện.

Các tham số:

photoMetadata	`GMSPlacePhotoMetadata` để tải `UIImage`.
số gọi lại	Lệnh gọi lại để gọi `UIImage` đã tải.

- (vô hiệu) loadPlaceẢnh:	(GMSPlacePhotoMetadata *)	photoMetadata
BoundToSize:	(Kích thước CG)	maxSize
tỷ lệ:	(CGFloat)	tỷ lệ
gọi lại:	(GMSPlacePhotoImageResultCallback)	lệnh gọi lại

Tải hình ảnh cho một ảnh cụ thể, được điều chỉnh theo tỷ lệ cho vừa với kích thước tối đa nhất định.

Hình ảnh sẽ được chia tỷ lệ để vừa với kích thước đã cho trong khi vẫn duy trì tỷ lệ cỡ ảnh của hình ảnh gốc. Việc chuyển tỷ lệ này được thực hiện phía máy chủ.

Nếu thông số tỷ lệ không phải là 1.0 maxSize sẽ được nhân với giá trị này và UIImage trả về sẽ được đặt để có tỷ lệ được chỉ định. Bạn nên đặt tham số này thành tỷ lệ màn hình nếu đang tải hình ảnh để hiển thị trên màn hình.

SDK có thể lưu dữ liệu hình ảnh vào bộ nhớ đệm. Nếu ảnh được yêu cầu không tồn tại trong bộ nhớ đệm thì tra cứu mạng sẽ được thực hiện.

Lưu ý:: Sau khi áp dụng hệ số tỷ lệ, các kích thước trong maxSize sẽ được làm tròn thành số nguyên gần nhất trước khi sử dụng. Nếu hình ảnh được yêu cầu lớn hơn kích thước tối đa hiện có, hệ thống có thể trả về hình ảnh nhỏ hơn.

Các tham số:

photoMetadata	`GMSPlacePhotoMetadata` để tải `UIImage`.
maxSize	Kích thước tối đa của hình ảnh.
tỷ lệ	Tỷ lệ để tải hình ảnh.
số gọi lại	Lệnh gọi lại để gọi `UIImage` đã tải.

– (vô hiệu) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) lệnh gọi lại

Trả về kết quả ước tính về vị trí hiện đã xác định được vị trí của thiết bị.

Tạo một danh sách khả năng về địa điểm dựa trên vị trí ước đoán gần đây nhất của thiết bị. Lệnh gọi lại đã cung cấp sẽ được gọi cùng với danh sách khả năng này khi thành công và NSError khi xảy ra lỗi.

Lưu ý:: Phương thức này yêu cầu ứng dụng của bạn có quyền truy cập vào thông tin vị trí hiện tại của thiết bị. Trước khi gọi lệnh này, hãy đảm bảo yêu cầu quyền truy cập vào vị trí của người dùng bằng [CLLocationManager request WhenInUseUỷ quyền] hoặc [CLLocationManager requestAlwaysPermissions]. Nếu bạn gọi phương thức này nhưng ứng dụng của bạn không có trạng thái uỷ quyền chính xác, thì hệ thống sẽ gọi lệnh gọi lại kèm theo lỗi.

Các tham số:

số gọi lại Lệnh gọi lại để gọi bằng danh sách khả năng cho địa điểm.

– (vô hiệu) tìm kiếm Theo dõi Tự động Dự đoánTừ Truy vấn:	(NSString *)	truy vấn
lọc:	(GMSAutocompleteFilter có thể nhận giá trị rỗng *)	bộ lọc
sessionToken:	(có thể nhận giá trị rỗng GMSAutocompleteSessionToken *)	sessionToken
gọi lại:	(GMSAutocompletePredictionsCallback)	lệnh gọi lại

Tìm cụm từ gợi ý Tự động hoàn thành qua truy vấn văn bản.

Kết quả có thể tuỳ ý thiên về một vị trí nhất định hoặc bị giới hạn ở một khu vực. Phương thức này không chặn.

Lệnh gọi lại đã cung cấp sẽ được gọi cùng với một loạt các dự đoán tự động hoàn thành khi thành công và NSError khi xảy ra lỗi.

Các tham số:

query	Văn bản một phần cần tự động hoàn thành.
filter	Bộ lọc để áp dụng cho kết quả. Tham số này có thể bằng không.
sessionToken	`GMSAutocompleteSessionToken` để liên kết yêu cầu với một phiên thanh toán.
số gọi lại	Lệnh gọi lại để gọi các cụm từ gợi ý.

- (vô hiệu) tìm nạpPlaceFromPlaceID:	(NSString *)	placeID
Trường địa điểm:	(GMSPlaceField)	placeFields
sessionToken:	(có thể nhận giá trị rỗng GMSAutocompleteSessionToken *)	sessionToken
gọi lại:	(GMSPlaceResultCallback)	lệnh gọi lại

Tìm nạp thông tin chi tiết cho một địa điểm.

Phương thức này không chặn.

Các tham số:

placeID	Mã địa điểm cần tra cứu.
placeFields	Các trường địa điểm riêng lẻ được yêu cầu cho các đối tượng địa điểm trong danh sách.
sessionToken	`GMSAutocompleteSessionToken` để liên kết yêu cầu với một phiên thanh toán.
số gọi lại	Lệnh gọi lại để gọi kết quả tra cứu.

- (vô hiệu) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:	(GMSPlaceField)	placeFields
gọi lại:	(GMSPlaceLikelihoodsCallback)	lệnh gọi lại

Tìm các khả năng về địa điểm bằng cách sử dụng vị trí hiện tại của người dùng.

Phương thức này không chặn.

Lệnh gọi lại đã cung cấp sẽ được gọi với một loạt các địa điểm có điểm khả năng khi thành công và NSError khi xảy ra lỗi.

Các tham số:

placeFields	Các trường địa điểm riêng lẻ được yêu cầu cho các đối tượng địa điểm trong danh sách.
số gọi lại	Lệnh gọi lại để gọi các khả năng về địa điểm.

- (vô hiệu) isOpenWithPlaceID:	(NSString *)	placeID
gọi lại:	(GMSPlaceOpenStatusCallback)	lệnh gọi lại

Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định GMSPlaceOpenStatus ở thời điểm hiện tại.

Phương thức này không chặn.

Các tham số:

placeID	Mã địa điểm cần tra cứu.
số gọi lại	Lệnh gọi lại để gọi kết quả địa điểm.

- (vô hiệu) isOpenWithPlaceID:	(NSString *)	placeID
ngày:	(NSDate *)	ngày
gọi lại:	(GMSPlaceOpenStatusCallback)	lệnh gọi lại

Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định GMSPlaceOpenStatus tại NSDate được chỉ định.

Phương thức này không chặn.

Các tham số:

placeID	Mã địa điểm cần tra cứu.
date	`NSDate` để xác định trạng thái mở cửa.
số gọi lại	Lệnh gọi lại để gọi kết quả địa điểm.

- (vô hiệu) isOpenWithPlace:	(GMSPlace *)	địa điểm
gọi lại:	(GMSPlaceOpenStatusCallback)	lệnh gọi lại

Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định GMSPlaceOpenStatus ở thời điểm hiện tại.

Chỉ yêu cầu các trường bổ sung nếu GMSPlace không có mọi trường cần thiết, nếu không, GMSPlaceOpenStatus sẽ được trả về ngay lập tức trong lệnh gọi lại. Phương thức này không chặn.

Các tham số:

địa điểm	`GMSPlace` cần tra cứu.
số gọi lại	Lệnh gọi lại để gọi kết quả địa điểm.

- (vô hiệu) isOpenWithPlace:	(GMSPlace *)	địa điểm
ngày:	(NSDate *)	ngày
gọi lại:	(GMSPlaceOpenStatusCallback)	lệnh gọi lại

Lấy thông tin chi tiết về một địa điểm, bao gồm tất cả các trường cần thiết để xác định GMSPlaceOpenStatus tại NSDate được chỉ định.

Chỉ yêu cầu các trường bổ sung nếu GMSPlace không có mọi trường cần thiết, nếu không, GMSPlaceOpenStatus sẽ được trả về ngay lập tức trong lệnh gọi lại. Phương thức này không chặn.

Các tham số:

địa điểm	`GMSPlace` cần tra cứu.
date	`NSDate` để xác định trạng thái mở cửa.
số gọi lại	Lệnh gọi lại để gọi kết quả địa điểm.

– (vô hiệu) searchByTextWithRequest:	(GMSPlaceSearchByTextRequest *)	textSearchRequest
gọi lại:	(GMSPlaceSearchByTextResultCallback)	lệnh gọi lại

Tìm địa điểm theo văn bản và các quy định hạn chế.

Phương thức này không chặn.

Các tham số:

textSearchRequest	`GMSPlaceSearchByTextRequest` Yêu cầu dạng văn bản để sử dụng cho truy vấn.
số gọi lại	Lệnh gọi lại để gọi kết quả tra cứu.

– (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable results, NSError *_Nullable error)) [related]

Loại lệnh gọi lại để nhận nội dung tra cứu thông tin chi tiết về địa điểm.

Nếu xảy ra lỗi, result sẽ bằng 0 và error sẽ chứa thông tin về lỗi.

Các tham số:

kết quả	`GMSPlace` được trả về.
error	Lỗi đã xảy ra, nếu có.

– (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_NullableabilitiesList, NSError *_Nullable error)) [related]

Loại lệnh gọi lại để nhận danh sách khả năng xử lý địa điểm.

Nếu xảy ra lỗi, likelihoodList sẽ bằng 0 và error sẽ chứa thông tin về lỗi.

Các tham số:

likelihoodList	Danh sách các khả năng về địa điểm.
error	Lỗi đã xảy ra, nếu có.

– (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable khả năng, NSError *_Nullable error)) [related]

Loại lệnh gọi lại để nhận mảng GMSPlaceLikelihood.

Nếu xảy ra lỗi, mảng này sẽ có giá trị bằng không và error sẽ chứa thông tin về lỗi.

– (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable kết quả, NSError *_lỗi có giá trị rỗng)) [related]

Loại lệnh gọi lại để nhận kết quả tự động hoàn thành.

results là một mảng các GMSAutofillPredictions biểu thị các ứng viên hoàn thành truy vấn.

Các tham số:

kết quả	Một mảng gồm `GMSAutocompletePrediction`.
error	Lỗi đã xảy ra, nếu có.

– (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable ảnh, NSError *_Nullable error)) [related]

Loại lệnh gọi lại để nhận kết quả hình ảnh địa điểm.

Nếu xảy ra lỗi, photos sẽ bằng 0 và error sẽ chứa thông tin về lỗi.

Các tham số:

ảnh	Kết quả chứa đối tượng `GMSPlacePhotoMetadata`.
error	Lỗi đã xảy ra, nếu có.

– (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable ảnh, NSError *_Nullable error)) [related]

Loại lệnh gọi lại để nhận đối tượng UIImage từ đối tượng GMSPlacePhotoMetadata.

Nếu xảy ra lỗi, photo sẽ bằng 0 và error sẽ chứa thông tin về lỗi.

Các tham số:

ảnh	`UIImage` đã được tải.
error	Lỗi đã xảy ra, nếu có.

– (typedef void(^ GMSPlaceOpenStatusCallback)(kết quả GMSPlaceOpenStatus, NSError *_Nullable)) [related]

Loại lệnh gọi lại để nhận trạng thái giờ mở cửa cho Địa điểm.

Nếu xảy ra lỗi, result sẽ là GMSPlaceOpenStatusUnknown và error sẽ chứa thông tin về lỗi.

Các tham số:

kết quả	`GMSPlaceOpenStatus` được trả về.
error	Lỗi đã xảy ra, nếu có.

– (typedef void(^ GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

Loại lệnh gọi lại để nhận kết quả tìm kiếm bằng văn bản.

results là một mảng GMSPlace đại diện cho từng kết quả riêng lẻ khớp với truy vấn.

Các tham số:

kết quả	Một mảng gồm `GMSPlace`.
error	Lỗi đã xảy ra, nếu có.

Tài liệu tham khảo về lớp GMSPlaceClient

Tổng quan

Hàm thành viên công khai

Hàm thành viên công khai tĩnh

Hàm liên quan

Tài liệu về hàm thành phần

Tài liệu về tính năng bạn bè và hàm liên quan