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 bao gồm thông tin về một vị trí thực tế, bao gồm tên, vị trí và bất kỳ thông tin nào 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 phần công khai

(GMSPlaceOpenStatus)isOpenAtDate:
 Không sử dụ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].

Tài sản

NSString *name
 Tên địa điểm.
NSString *placeID
 Mã địa điểm của địa điểm này.
CLLocationLocation2Dtọ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ế, tức là
NSString *formattedAddress
 Địa chỉ của địa điểm dưới dạng một chuỗi đơn giản.
độ chính xác đơnxếp hạng
 Xếp hạng 5 sao cho địa điểm này dựa trên bài đánh giá của người dùng.
NSArray< GMSPlaceReview * > *bài đánh giá
 Một mảng các đối tượng GMSPlaceReview đại diện cho các bài đánh giá của người dùng về địa điểm.
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 hình của địa điểm này.
NSURL *trang web
 Trang web cho địa điểm này.
NS AttributesdString *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ã Cộng biểu thị vị trí cho địa điểm này.
GMSOpeningHours *openingHours
 Thông tin về Giờ mở cửa bình thường của doanh nghiệp cho địa điểm này.
GMSOpeningHours *currentOpeningHours
 Trả về giờ hoạt động 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 các ảnh về địa điểm.
Số NS *UTCOffsetMinutes
 Độ 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ề thông tin 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đồ ăn mang đi
 Đặt thuộc tính cho trải nghiệm trích xuất dữ liệu.
GMSBooleanPlaceAttributegiao hàng
 Thuộc tính địa điểm cho dịch vụ giao hàng.
GMSBooleanPlaceAttributedineIn
 Thuộc tính địa điểm cho trải nghiệm dùng bữa.
GMSBooleanPlaceAttributecurbsidePickup
 Thuộc tính địa điểm cho dịch vụ nhận hàng ở lề đường.
GMSBooleanPlaceAttributecó thể đặt lại
 Thuộc tính địa điểm cho biết mộ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 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 địa điểm 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 lối vào.

Tài liệu về chức năng của thành viên

– (GMSPlaceOpenStatus) isOpenAtDate: (Ngày NS *) ngày

Không sử dụ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, UTCOffsetMinutesdate.

Các tham số:
dateMột điểm tham chiếu trong thời gian 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ở, GMSPlaceOpenStatusStatus đóng nếu địa điểm đóng cửa và GMSPlaceOpenStatusUnknown nếu địa điểm 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à thay vào đó là 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ường hợp trả lại hàng:
GMSPlaceOpenStatusOpen nếu địa điểm đang mở, GMSPlaceOpenStatusStatus đóng nếu địa điểm đóng cửa và GMSPlaceOpenStatusUnknown nếu địa điểm 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òn được dùng nữa, thay vào đó là 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*) tên [read, copy]

Tên địa điểm.

– (NSString*) placeID [read, copy]

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

– (CLLocationLocation2D) 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ỳ điểm ra hoặc vào 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ế, ví dụ:

bao gồm cả mã quốc gia có tiền tố là dấu "+". 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 độ chính xác đơn) xếp hạng [read, assign]

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

Mức phân loại từ 1,0 đến 5,0. 0.0 có nghĩa là chúng tôi không có xếp hạng cho địa điểm này (ví dụ: không có đủ người dùng đã đánh giá địa điểm này).

- (NSArray<GMSPlaceReview *>*) bài đánh giá [read, copy]

Một mảng các đối tượng GMSPlaceReview đại diện cho các 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 là "$$$$" (đắt). Giá trị 0 có nghĩa là miễn phí (chẳng hạn như một bảo tàng có vé vào cửa miễn phí).

– (NSArray<NSString *>*) loại [read, copy]

Các loại hình của địa điểm này.

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

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

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

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

– (GMSPlaceViewportInfo*) viewportInfo [read, assign]

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

Có thể là giá trị bằng không nếu không xác định được quy mô của địa điểm.

Thao tác này sẽ trả về khung nhìn có kích thước phù hợp để hiển thị địa điểm này. Ví dụ: đối tượng GMSPlace biểu thị một cửa hàng có thể có một khung nhìn tương đối nhỏ, trong khi đối tượng GMSPlace biểu thị 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 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ó địa điểm đó.

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

– (GMSPlusCode*) plusCode [read, assign]

Mã Cộng biểu thị vị trí cho địa điểm này.

– (GMSOpeningHours*) openingHours [read, assign]

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

Bao gồm trạng thái mở cửa, 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ờ hoạt động 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 của ngày gửi yêu cầu và kết thúc lúc 23:59 đêm sáu ngày sau đó.

Các mục GMSPlaceSpecialDay 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ờ chính của doanh nghiệp. Ví dụ: một nhà hàng có thể chỉ định giờ mua hàng tận nơi hoặc giờ giao hàng làm giờ phụ. Hãy xem GMSPlaceHoursType để biết các loại giờ phụ.

Các mục GMSPlaceSpecialDay 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 *>*) ảnh [read, copy]

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

– (NSNumber*) UTCOffsetMinutes [read, assign]

Độ 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ề thông tin 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 cho chế độ xem 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 kích thước hình ảnh có thể khác nhau tuỳ theo loại.

Đặt thuộc tính cho trải nghiệm trích xuất dữ liệu.

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

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

– (GMSBooleanPlaceAttribute) dineIn [read, assign]

Thuộc tính địa điểm cho trải nghiệm dùng bữa.

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 mộ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 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 địa điểm 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 tại lối vào.