GMSPlace 類別參考資料

公開成員函式 | 資源

GMSPlace 類別參考

---

總覽

代表特定實際地點。

一個 GMSPlace 包含關於實際位置的資訊，包括其名稱、位置以及我們所擁有的任何其他資訊。這個類別無法變更。

公開成員函式
(GMSPlaceOpenStatus)	- isOpenAtDate:
	無法使用預設 init。
(GMSPlaceOpenStatus)	- isOpen
	根據 openingHours、UTCOffsetMinutes，以及目前取得的 [NSDate date] 日期/時間，計算地點是否營業中。
房源
NSString *	name
	地點名稱。
NSString *	placeID
	這個地點的地點 ID。
CLLocationCoordinate2D	座標
	地點位置。
NSString *	電話號碼
	這個地點的電話號碼，以國際電話號碼格式表示，例如：
NSString *	formattedAddress
	地點的地址，以簡易字串表示。
浮點值	評分
	根據使用者評論，這個地點的 5 顆星評分。
NSArray<GMSPlaceReview * >。	評論
	GMSPlaceReview 物件陣列，代表地點的使用者評論。
GMSPlacesPriceLevel	priceLevel
	這個地點的價位，為 0 到 4 之間的整數。
NSArray<NSString * >。	類型
	這個地點的類型。
NSURL *	網站
	這個地點的網站。
NSAttributedString *	歸因
	這個地點的資料供應商歸因字串。
GMSPlaceViewportInfo *	viewportInfo
	這個地點的建議可視區域。
NSArray<GMSAddressComponent * >。	addressComponents
	GMSAddressComponent 物件陣列，代表地點地址中的元件。
GMSPlusCode *	plusCode
	這個地點的位置 Plus Code 表示法。
GMSOpeningHours *	openingHours
	這個地點的一般商家營業時間資訊。
GMSOpeningHours *	currentOpeningHours
	傳回此地點未來 7 天的營業時間。
NSArray<GMSOpeningHours * >。	secondaryOpeningHours
	傳回此地點未來 7 天內次要小時的作業陣列。
NSUInteger	userRatingsTotal
	代表這個地點評分所涵蓋的評論數量。
NSArray<GMSPlacePhotoMetadata * >。	相片
	代表地點相片的 GMSPlacePhotoMetadata 物件陣列。
NSNumber *	UTCOffsetMinutes
	地點的時區 (世界標準時間)，以分鐘為單位。
GMSPlacesBusinessStatus	businessStatus
	地點的 GMSPlaceBusinessStatus。
NSString *	editorialSummary
	傳回此地點的編輯摘要。
使用者介面顏色 *	iconBackgroundColor
	根據地點類型，圖示的背景顏色，為圖示後方的檢視畫面上色。
NSURL *	iconImageURL
	依據地點類型顯示的網址，可用來擷取「地點」圖示的 NSData。
GMSBooleanPlaceAttribute	匯出
	外帶體驗的地點屬性。
GMSBooleanPlaceAttribute	配送
	配送服務的地點屬性。
GMSBooleanPlaceAttribute	dineIn
	提供內用服務的地點屬性。
GMSBooleanPlaceAttribute	curbsidePickup
	店外取貨服務的地點屬性。
GMSBooleanPlaceAttribute	可預訂
	表示地點受到旅客歡迎的地點屬性。
GMSBooleanPlaceAttribute	servesBreakfast
	表示地點供應早餐的地點屬性。
GMSBooleanPlaceAttribute	servesLunch
	指出地點供應午餐的地點屬性。
GMSBooleanPlaceAttribute	servesDinner
	表示地點供應晚餐的地點屬性。
GMSBooleanPlaceAttribute	servesBeer
	指出地點供應啤酒的地點屬性。
GMSBooleanPlaceAttribute	servesWine
	指出地點供應葡萄酒的地點屬性。
GMSBooleanPlaceAttribute	servesBrunch
	指出地點提供早午餐的地點屬性。
GMSBooleanPlaceAttribute	servesVegetarianFood
	表示地點供應素食地點的地點屬性。
GMSBooleanPlaceAttribute	wheelchairAccessibleEntrance
	「地點屬性」表示地點在入口處有無障礙設施。

---

成員職能說明文件

- (GMSPlaceOpenStatus) isOpenAtDate:

(NSDate *)

日期

無法使用預設 init。

根據 openingHours、UTCOffsetMinutes 和 date 計算地點是否營業。

參數：

日期	用來判斷地點是否營業的參考時間點。

傳回：

GMSPlaceOpenStatusOpen (如果地點營業中)，GMSPlaceOpenStatusClosed (如果商家已停業) 和 GMSPlaceOpenStatusUnknown (如果商家營業狀態不明)。

注意：

這項功能已淘汰，此方法已淘汰，並改用 GMSPlacesClient::isOpenAtDate:place:date:callback</ code> and will be removed in a future release.

- (GMSPlaceOpenStatus) isOpen

根據 openingHours、UTCOffsetMinutes，以及目前取得的 [NSDate date] 日期/時間，計算地點是否營業中。

傳回：

GMSPlaceOpenStatusOpen (如果地點營業中)，GMSPlaceOpenStatusClosed (如果商家已停業) 和 GMSPlaceOpenStatusUnknown (如果商家營業狀態不明)。

注意：

這項功能已淘汰，此方法已淘汰，並改用 GMSPlacesClient::isOpen:place:callback，將在日後推出的版本中移除。

---

屬性說明文件

- (NSString*) <名稱> [read, copy]

地點名稱。

- (NSString*) <地點 ID>placeID [read, copy]

這個地點的地點 ID。

- (CLLocationCoordinate2D) 座標 [read, assign]

地點位置。

該位置不一定是「地點」的中心，或任何特定進入或結束點，但可任意選擇的「地點」地理範圍中的點。

- (NSString*) phoneNumber [read, copy]

這個地點的電話號碼，以國際電話號碼格式表示，例如

且開頭必須是「+」的國家/地區代碼。舉例來說，Google 雪梨的電話號碼是「[phone]」。

- (NSString*) formattedAddress [read, copy]

地點的地址，以簡易字串表示。

- (浮動) rating [read, assign]

根據使用者評論，這個地點的 5 顆星評分。

評分範圍介於 1.0 至 5.0 之間。0.0 表示沒有任何這個地點的評分 (例如，因為使用者的評論不足)。

- (NSArray<GMSPlaceReview *>*) 評論 [read, copy]

GMSPlaceReview 物件陣列，代表地點的使用者評論。

- (GMSPlacesPriceLevel) priceLevel [read, assign]

這個地點的價位，為 0 到 4 之間的整數。

例如：如果值為 4，表示這個地點是「$$$$」(昂貴)。如果值為 0，表示免費 (例如提供免費門票的博物館)。

- (NSArray<NSString *>*) 類型 [read, copy]

這個地點的類型。

類型為 NSString，有效值為 <https://developers.google.com/places/ios-sdk/supported_types> 列出的任何類型。

- (NSURL*) 網站 [read, copy]

這個地點的網站。

- (NSAttributedString*) 歸因 [read, copy]

這個地點的資料供應商歸因字串。

這些字串是以 NSAttributedString 形式提供，其中含有每個供應商網站的超連結。

一般而言，如果資料來自此資訊，就必須向使用者顯示 GMSPlace，如《Places SDK 服務條款》所述。

- (GMSPlaceViewportInfo*) viewportInfo [read, assign]

這個地點的建議可視區域。

如果地點大小不明，則為 nil。

這會傳回適合顯示這個地點的大小可視區域。舉例來說，代表商店的 GMSPlace 物件可能會有相對較小的可視區域，而代表國家/地區的 GMSPlace 物件則有非常大的可視區域。

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

GMSAddressComponent 物件陣列，代表地點地址中的元件。

這些元件旨在擷取地點地址的結構化資訊，例如尋找地點所在的城市。

這些元件不得用於設定地址格式。如果需要格式化的地址，請使用 formattedAddress 屬性，此屬性提供本地化格式的地址。

- (GMSPlusCode*) plusCode [read, assign]

這個地點的位置 Plus Code 表示法。

- (GMSOpeningHours*) openingHours [read, assign]

這個地點的一般商家營業時間資訊。

包含營業狀態、經期和平日文字 (如果有的話)。

- (GMSOpeningHours*) currentOpeningHours [read, assign]

傳回此地點未來 7 天的營業時間。

時間範圍會從要求日期的午夜開始，並在六天後的晚上 11:59 結束。

GMSOpeningHours 的 GMSPlaceSpecialDay 個項目只會顯示在 GMSPlace currentOpeningHours 和 GMSPlace secondaryOpeningHours。

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

傳回此地點未來 7 天內次要小時的作業陣列。

次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以將「得來速」或「外送服務」指定為次要營業時間。請參閱 GMSPlaceHoursType，瞭解不同的次要營業時間類型。

GMSOpeningHours 的 GMSPlaceSpecialDay 個項目只會顯示在 GMSPlace currentOpeningHours 和 GMSPlace secondaryOpeningHours。

- (NSUInteger) userRatingsTotal [read, assign]

代表這個地點評分所涵蓋的評論數量。

- (NSArray<GMSPlacePhotoMetadata *>*) 相片 [read, copy]

代表地點相片的 GMSPlacePhotoMetadata 物件陣列。

- (NSNumber*) UTCOffsetMinutes [read, assign]

地點的時區 (世界標準時間)，以分鐘為單位。

- (GMSPlacesBusinessStatus) businessStatus [read, assign]

地點的 GMSPlaceBusinessStatus。

- (NSString*) editorialSummary [read, copy]

傳回此地點的編輯摘要。

- (UIColor*) iconBackgroundColor [read, assign]

根據地點類型，圖示的背景顏色，為圖示後方的檢視畫面上色。

- (NSURL*) iconImageURLiconImageURL [read, assign]

依據地點類型顯示的網址，可用來擷取「地點」圖示的 NSData。

注意：網址連結不會過期，圖片大小顯示比例可能會因類型而異。

- (GMSBooleanPlaceAttribute) 外帶 [read, assign]

外帶體驗的地點屬性。

- (GMSBooleanPlaceAttribute) delivery [read, assign]

配送服務的地點屬性。

- (GMSBooleanPlaceAttribute) dineIn [read, assign]

提供內用服務的地點屬性。

- (GMSBooleanPlaceAttribute) curbsidePickup [read, assign]

店外取貨服務的地點屬性。

- (GMSBooleanPlaceAttribute) reservable [read, assign]

表示地點受到旅客歡迎的地點屬性。

- (GMSBooleanPlaceAttribute) servesBreakfast [read, assign]

表示地點供應早餐的地點屬性。

- (GMSBooleanPlaceAttribute) servesLunch [read, assign]

指出地點供應午餐的地點屬性。

- (GMSBooleanPlaceAttribute) servesDinner [read, assign]

表示地點供應晚餐的地點屬性。

- (GMSBooleanPlaceAttribute) servesBeer [read, assign]

指出地點供應啤酒的地點屬性。

- (GMSBooleanPlaceAttribute) servesWine [read, assign]

指出地點供應葡萄酒的地點屬性。

- (GMSBooleanPlaceAttribute) servesBrunch [read, assign]

指出地點提供早午餐的地點屬性。

- (GMSBooleanPlaceAttribute) servesVegetarianFood [read, assign]

表示地點供應素食地點的地點屬性。

- (GMSBooleanPlaceAttribute) wheelchairAccessibleEntrance [read, assign]

「地點屬性」表示地點在入口處有無障礙設施。