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

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

Tổng quan

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

GMSPlace đóng gói 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ề địa điểm đó. Lớp này 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 của địa điểm.
NSString * placeID
 Mã địa điểm của địa điểm này.
CLLocationCoordinate2Dtọ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
 Điểm 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.
GMSPlacesPriceLevelpriceLevel
 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 thuộc tính nhà cung cấp dữ liệu cho địa điểm này.
GMSPlaceViewportInfoviewportInfo
 Khung nhìn đề xuất cho địa điểm này.
NSArray< GMSAddressComponent * > * addressComponents
 Một mảng các đối tượng GMSAddressComponent đại diện cho các thành phần trong địa chỉ của địa điểm.
GMSPlusCodeplusCode
 Mã Plus đại diện cho vị trí của địa điểm này.
GMSOpeningHoursopeningHours
 Thông tin về Giờ mở cửa thông thường của doanh nghiệp cho địa điểm này.
GMSOpeningHourscurrentOpeningHours
 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.
NSUIntegeruserRatingsTotal
 Thể hiện số lượng bài đánh giá tạo nên điểm xếp hạng của địa điểm này.
NSArray< GMSPlacePhotoMetadata * > * ảnh
 Một mảng gồm các đối tượng GMSPlacePhotoMetadata đạ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.
GMSPlacesBusinessStatusbusinessStatus
 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 khung hiển thị 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.
GMSBooleanPlaceAttributeTakeout
 Thuộc tính vị trí cho trải nghiệm trích xuất.
GMSBooleanPlaceAttributephân phối
 Thuộc tính địa điểm cho dịch vụ giao hàng.
GMSBooleanPlaceAttributedineIn
 Đặt thuộc tính để dùng bữa trong trải nghiệm.
GMSBooleanPlaceAttributecurbsidePickup
 Thuộc tính địa điểm cho dịch vụ nhận hàng ở lề đường.
GMSBooleanPlaceAttributecó thể đặt trước
 Thuộc tính địa điểm cho biết địa điểm nổi tiếng với du khách.
GMSBooleanPlaceAttributeservesBreakfast
 Thuộc tính địa điểm cho biết địa điểm có phục vụ bữa sáng.
GMSBooleanPlaceAttributeservesLunch
 Thuộc tính địa điểm cho biết địa điểm phục vụ bữa trưa.
GMSBooleanPlaceAttributeservesDinner
 Thuộc tính địa điểm cho biết địa điểm phục vụ bữa tối.
GMSBooleanPlaceAttributeservesBeer
 Thuộc tính địa điểm cho biết địa điểm phục vụ bia.
GMSBooleanPlaceAttributeservesWine
 Thuộc tính địa điểm cho biết địa điểm phục vụ rượu vang.
GMSBooleanPlaceAttributeservesBrunch
 Thuộc tính Place cho biết địa điểm phục vụ bữa nửa buổi.
GMSBooleanPlaceAttributeservesVegetarianFood
 Thuộc tính địa điểm cho biết địa điểm phục vụ đồ ăn chay.
GMSBooleanPlaceAttributewheelchairAccessibleEntrance
 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 *) date

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

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

Các tham số:
dateThời điểm tham chiếu dùng để xác định xem địa điểm có mở cửa hay không.
Trả về:
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ở không xác định.
Lưu ý:
Phiên bản này không còn dùng nữa. Phương thức này không còn đượ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.

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ả về:
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ở không xác định.
Lưu ý:
Phiên bản này không còn 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ề thuộc tính

– (NSString*) name [read, copy]

Tên của địa điểm.

– (NSString*) placeID [read, copy]

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

- Tọa độ (CLLocationCoordinate2D) [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 hoặc bất kỳ điểm vào hoặc 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ố là "+". 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.

- (số thực) xếp hạng [read, assign]

Điểm 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.

Điểm xếp hạng nằm trong khoảng từ 1 đến 5. 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).

– (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 là "$$$$" (đắt đỏ). Giá trị 0 có nghĩa là miễn phí (chẳng hạn như bảo tàng cho phép vào cửa miễn phí).

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

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

Loại là NSStrings, giá trị hợp lệ là bất kỳ loại nào được ghi 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 thuộc tính nhà cung cấp dữ liệu cho địa điểm này.

Chúng được cung cấp dưới dạng NSAttributesString, 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, các ứng dụng và tiện ích này phải được hiển thị cho người dùng nếu dữ liệu từ GMSPlace được hiển thị, như mô tả trong Điều khoản dịch vụ của SDK Địa điểm.

– (GMSPlaceViewportInfo*) viewportInfo [read, assign]

Khung nhìn đề 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ó một khung nhìn tương đối nhỏ, trong khi một đối tượng GMSPlace đại diện cho một quốc gia có thể có một khung nhìn rất lớn.

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

Một mảng 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ạn bắt buộc phải định dạng địa chỉ, hãy sử dụng thuộc tính formattedAddress để cung cấp một địa chỉ đã định dạng đã được 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 thông thường của doanh nghiệp 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 từ nửa đêm vào ngày yêu cầu và kết thúc lúc 23:59 đêm hôm sau.

GMSPlaceSpecialDay mục trên GMSOpeningHours sẽ chỉ xuất hiện cho GMSPlace currentOpeningHoursGMSPlace 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ờ làm việc phụ khác với giờ hoạt động chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ lái xe hoặc giờ giao hàng làm giờ phụ. Hãy xem GMSPlaceHoursType để biết các loại giờ phụ.

GMSPlaceSpecialDay mục trên GMSOpeningHours sẽ chỉ xuất hiện cho GMSPlace currentOpeningHoursGMSPlace secondaryOpeningHours.

– (NSUInteger) userRatingsTotal [read, assign]

Thể hiện số lượng bài đánh giá tạo nên điểm xếp hạng của địa điểm này.

– (NSArray<GMSPlacePhotoMetadata *>*) photos [read, copy]

Một mảng gồm các đối tượng GMSPlacePhotoMetadata đại diện cho ảnh của địa điểm.

– (NSNumber*) UTCOffsetMinutes [read, assign]

Chênh lệch múi giờ UTC của địa điểm tính bằng phút.

GMSPlaceBusinessStatus của địa điểm.

– (NSString*) editorialSummary [read, copy]

Trả về bản tóm tắt biên tập của địa điểm này.

– (UIColor*) iconBackgroundColor [read, assign]

Màu nền của biểu tượng theo loại Địa điểm, để tô màu khung hiển thị phía sau biểu tượng.

– (NSURL*) iconImageURL [read, assign]

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.

LƯU Ý: Đường liên kết URL không hết hạn và tỷ lệ khung hình của kích thước hình ảnh có thể khác nhau tuỳ thuộc vào loại.

Thuộc tính vị trí cho trải nghiệm trích xuất.

Phân phối [read, assign] (GMSBooleanPlaceAttribute)

Thuộc tính địa điểm cho dịch vụ giao hàng.

– (GMSBooleanPlaceAttribute) dineIn [read, assign]

Đặt thuộc tính để dùng bữa trong trải nghiệm.

Thuộc tính địa điểm cho dịch vụ nhận hàng ở lề đường.

Thuộc tính địa điểm cho biết địa điểm nổi tiếng với du khách.

Thuộc tính địa điểm cho biết địa điểm có phục vụ bữa sáng.

– (GMSBooleanPlaceAttribute) servesLunch [read, assign]

Thuộc tính địa điểm cho biết địa điểm phục vụ bữa trưa.

– (GMSBooleanPlaceAttribute) servesDinner [read, assign]

Thuộc tính địa điểm cho biết địa điểm phục vụ bữa tối.

– (GMSBooleanPlaceAttribute) servesBeer [read, assign]

Thuộc tính địa điểm cho biết địa điểm phục vụ bia.

– (GMSBooleanPlaceAttribute) servesWine [read, assign]

Thuộc tính địa điểm cho biết địa điểm phục vụ rượu vang.

– (GMSBooleanPlaceAttribute) servesBrunch [read, assign]

Thuộc tính Place cho biết địa điểm phục vụ bữa nửa buổi.

Thuộc tính địa điểm cho biết địa điểm phục vụ đồ ăn chay.

Thuộc tính địa điểm cho biết địa điểm có lối vào cho xe lăn.