Tổng quan

Đại diện cho một địa điểm thực tế cụ thể.

GMSPlace bao gồm thông tin về một vị trí thực tế, bao gồm tên, vị trí và mọi thông tin khác mà chúng tôi có thể có về vị trí đó. Lớp này là không thể thay đổi.

Hàm thành viên công khai
(GMSPlaceOpenStatus)	– isOpenAtDate:
	Không có init mặc định.
(GMSPlaceOpenStatus)	– isOpen
	Tính toán xem một địa điểm có mở cửa hay không dựa trên `openingHours`, `UTCOffsetMinutes` và ngày giờ hiện tại thu được từ `[NSDate date]`.
Thuộc tính
NSString *	name
	Tên địa điểm.
NSString *	placeID
	Mã địa điểm của địa điểm này.
CLLocationVị trí2D	tọa độ
	Vị trí của địa điểm.
NSString *	phoneNumber
	Số điện thoại của địa điểm này, ở định dạng quốc tế, ví dụ:
NSString *	formattedAddress
	Địa chỉ của địa điểm dưới dạng một chuỗi đơn giản.
float	điểm xếp hạng
	Xếp hạng 5 sao cho địa điểm này dựa trên các bài đánh giá của người dùng.
NSArray< GMSPlaceReview * > *	bài đánh giá
	Một mảng gồm các đối tượng `GMSPlaceReview` đại diện cho bài đánh giá của người dùng về địa điểm.
GMSPlacesPriceLevel	priceLevel
	Mức giá cho địa điểm này, dưới dạng số nguyên từ 0 đến 4.
NSArray< NSString * > *	loại
	Các loại địa điểm này.
NSURL *	trang web
	Trang web cho địa điểm này.
NSAttributionString *	phân bổ
	Chuỗi phân bổ nhà cung cấp dữ liệu cho địa điểm này.
GMSPlaceViewportInfo *	viewportInfo
	Khung nhìn được đề xuất cho địa điểm này.
NSArray< GMSAddressComponent * > *	addressComponents
	Một mảng gồm các đối tượng `GMSAddressComponent` đại diện cho các thành phần trong địa chỉ của địa điểm.
GMSPlusCode *	plusCode
	Mã Plus đại diện cho vị trí của địa điểm này.
GMSOpeningHours *	openingHours
	Thông tin về Giờ mở cửa bình thường cho địa điểm này.
GMSOpeningHours *	currentOpeningHours
	Trả về giờ làm việc của địa điểm này trong 7 ngày tiếp theo.
NSArray< GMSOpeningHours * > *	secondaryOpeningHours
	Trả về một mảng gồm(các) giờ hoạt động phụ của địa điểm này trong 7 ngày tiếp theo.
NSUInteger	userRatingsTotal
	Thể hiện số lượng bài đánh giá tạo nên điểm xếp hạng cho địa điểm này.
NSArray< GMSPlacePhotoMetadata * > *	ảnh
	Một mảng gồm `GMSPlacePhotoMetadata` đối tượng đại diện cho ảnh của địa điểm.
NSNumber *	UTCOffsetMinutes
	Chênh lệch múi giờ UTC của địa điểm tính bằng phút.
GMSPlacesBusinessStatus	businessStatus
	`GMSPlaceBusinessStatus` của địa điểm.
NSString *	editorialSummary
	Trả về bản tóm tắt biên tập của địa điểm này.
UIColor *	iconBackgroundColor
	Màu nền của biểu tượng theo loại Địa điểm, để tô màu cho chế độ xem phía sau biểu tượng.
NSURL *	iconImageURL
	URL theo loại Địa điểm mà bạn có thể sử dụng để truy xuất NSData của biểu tượng Địa điểm.
GMSBooleanPlaceAttribute	Takeout
	Đặt thuộc tính cho trải nghiệm trích xuất.
GMSBooleanPlaceAttribute	giao hàng
	Thuộc tính Vị trí cho dịch vụ phân phối.
GMSBooleanPlaceAttribute	dineIn
	Đặt thuộc tính để dùng bữa trong trải nghiệm.
GMSBooleanPlaceAttribute	curbsidePickup
	Đặt thuộc tính cho dịch vụ nhận hàng ở lề đường.
GMSBooleanPlaceAttribute	đặt trước
	Thuộc tính địa điểm cho biết địa điểm này đông khách du lịch.
GMSBooleanPlaceAttribute	servesBreakfast
	Thuộc tính địa điểm cho biết địa điểm phục vụ bữa sáng.
GMSBooleanPlaceAttribute	servesLunch
	Thuộc tính địa điểm cho biết địa điểm phục vụ bữa trưa.
GMSBooleanPlaceAttribute	servesDinner
	Thuộc tính địa điểm cho biết địa điểm phục vụ bữa tối.
GMSBooleanPlaceAttribute	servesBeer
	Thuộc tính địa điểm cho biết địa điểm phục vụ bia.
GMSBooleanPlaceAttribute	servesWine
	Thuộc tính địa điểm cho biết địa điểm phục vụ rượu vang.
GMSBooleanPlaceAttribute	servesBrunch
	Thuộc tính Place cho biết địa điểm phục vụ bữa sáng muộn.
GMSBooleanPlaceAttribute	servesVegetarianFood
	Thuộc tính địa điểm cho biết địa điểm có phục vụ đồ ăn chay.
GMSBooleanPlaceAttribute	wheelchairAccessibleEntrance
	Thuộc tính địa điểm cho biết địa điểm có lối vào cho xe lăn.

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

– (GMSPlaceOpenStatus) isOpenAtDate: (NSDate *) ngày

Không có init mặc định.

Tính toán xem một địa điểm có mở cửa hay không dựa trên openingHours, UTCOffsetMinutes và date.

Các tham số:

date	Điểm tham chiếu dùng để xác định xem địa điểm có mở cửa hay không.

Trường hợp trả lại hàng:: GMSPlaceOpenStatusOpen nếu địa điểm đang mở cửa, GMSPlaceOpenStatusClosed nếu địa điểm đóng cửa và GMSPlaceOpenStatusUnknown nếu trạng thái mở cửa là không xác định.

Lưu ý:: Tính năng này không còn được dùng nữa. Phương thức này không được dùng nữa và được thay thế bằng GMSPlacesClient::isOpenAtDate:place:date:callback</ code> and will be removed in a future release.

– (GMSPlaceOpenStatus) isOpen

Tính toán xem một địa điểm có mở cửa hay không dựa trên openingHours, UTCOffsetMinutes và ngày giờ hiện tại thu được từ [NSDate date].

Trường hợp trả lại hàng:: GMSPlaceOpenStatusOpen nếu địa điểm đang mở cửa, GMSPlaceOpenStatusClosed nếu địa điểm đóng cửa và GMSPlaceOpenStatusUnknown nếu trạng thái mở cửa là không xác định.

Lưu ý:: Tính năng này không còn được dùng nữa. Phương thức này không được dùng nữa và được thay thế bằng GMSPlacesClient::isOpen:place:callback và sẽ bị xoá trong bản phát hành sau này.

Tài liệu về tài sản

– (NSString*) tên [read, copy]

Tên địa điểm.

– (NSString*) placeID [read, copy]

Mã địa điểm của địa điểm này.

- (CLLocation phối hợp2D) tọa độ [read, assign]

Vị trí của địa điểm.

Vị trí không nhất thiết là trung tâm của Địa điểm hay bất kỳ lối vào hay điểm ra cụ thể nào, mà là một số điểm được chọn tuỳ ý trong phạm vi địa lý của Địa điểm.

– (NSString*) phoneNumber [read, copy]

Số điện thoại của địa điểm này, ở định dạng quốc tế, tức là

bao gồm mã quốc gia có tiền tố "+". Ví dụ: số điện thoại của Google Sydney là "+61 2 9374 4000".

– (NSString*) formattedAddress [read, copy]

Địa chỉ của địa điểm dưới dạng một chuỗi đơn giản.

- (nổi) xếp hạng [read, assign]

Xếp hạng 5 sao cho địa điểm này dựa trên các bài đánh giá của người dùng.

Xếp hạng nằm trong khoảng từ 1,0 đến 5,0. 0.0 có nghĩa là chúng tôi không có điểm xếp hạng cho địa điểm này (ví dụ: vì chưa có đủ người dùng đánh giá địa điểm này).

– (NSArray<GMSPlaceReview *>*) đánh giá [read, copy]

Một mảng gồm các đối tượng GMSPlaceReview đại diện cho bài đánh giá của người dùng về địa điểm.

– (GMSPlacesPriceLevel) priceLevel [read, assign]

Mức giá cho địa điểm này, dưới dạng số nguyên từ 0 đến 4.

ví dụ: Giá trị 4 có nghĩa là địa điểm này "$$$$" (đắt). Giá trị 0 có nghĩa là miễn phí (chẳng hạn như bảo tàng miễn phí vào cửa).

– (NSArray<NSString *>*) types [read, copy]

Các loại địa điểm này.

Các loại là NSString, giá trị hợp lệ là bất kỳ loại nào được ghi lại tại <https://developers.google.com/places/ios-sdk/supported_types>.

- (NSURL*) trang web [read, copy]

Trang web cho địa điểm này.

– (NSAttributionString*) phân bổ [read, copy]

Chuỗi phân bổ nhà cung cấp dữ liệu cho địa điểm này.

Các thông số này được cung cấp dưới dạng NSAttributionString, có thể chứa các siêu liên kết đến trang web của từng nhà cung cấp.

Nói chung, những thông tin này phải được hiển thị cho người dùng nếu dữ liệu từ GMSPlace xuất hiện, như mô tả trong Điều khoản dịch vụ của SDK Địa điểm.

– (GMSPlaceViewportInfo*) viewportInfo [read, assign]

Khung nhìn được đề xuất cho địa điểm này.

Có thể không có giá trị nếu không xác định kích thước của địa điểm.

Thao tác này sẽ trả về một khung nhìn có kích thước phù hợp để hiển thị địa điểm này. Ví dụ: một đối tượng GMSPlace đại diện cho một cửa hàng có thể có khung nhìn tương đối nhỏ, trong khi đối tượng GMSPlace đại diện cho một quốc gia có thể có khung nhìn rất lớn.

– (NSArray<GMSAddressComponent *>*) addressComponents [read, copy]

Một mảng gồm các đối tượng GMSAddressComponent đại diện cho các thành phần trong địa chỉ của địa điểm.

Các thành phần này được cung cấp nhằm mục đích trích xuất thông tin có cấu trúc về địa chỉ của địa điểm, chẳng hạn như tìm thành phố có một địa điểm.

Bạn không nên sử dụng các thành phần này để định dạng địa chỉ. Nếu bắt buộc phải có địa chỉ được định dạng, hãy sử dụng thuộc tính formattedAddress. Thuộc tính này cung cấp địa chỉ được định dạng đã bản địa hoá.

– (GMSPlusCode*) plusCode [read, assign]

Mã Plus đại diện cho vị trí của địa điểm này.

– (GMSOpeningHours*) openingHours [read, assign]

Thông tin về Giờ mở cửa bình thường cho địa điểm này.

Bao gồm trạng thái mở, khoảng thời gian và văn bản ngày trong tuần (nếu có).

– (GMSOpeningHours*) currentOpeningHours [read, assign]

Trả về giờ làm việc của địa điểm này trong 7 ngày tiếp theo.

Khoảng thời gian này bắt đầu lúc nửa đêm ngày yêu cầu và kết thúc lúc 23:59 tối sáu ngày sau đó.

Các mục nhập GMSPlaceSpecialDay trên GMSOpeningHours sẽ chỉ xuất hiện trong GMSPlace currentOpeningHours và GMSPlace secondaryOpeningHours.

– (NSArray<GMSOpeningHours *>*) secondaryOpeningHours [read, copy]

Trả về một mảng gồm(các) giờ hoạt động phụ của địa điểm này trong 7 ngày tiếp theo.

Giờ phụ khác với giờ chính của doanh nghiệp. Ví dụ: nhà hàng có thể chỉ định giờ mua hàng trên xe hoặc giờ giao hàng làm giờ phụ. Hãy xem GMSPlaceHoursType để biết các loại giờ phụ khác nhau.

Các mục nhập GMSPlaceSpecialDay trên GMSOpeningHours sẽ chỉ xuất hiện trong GMSPlace currentOpeningHours và GMSPlace secondaryOpeningHours.