GMSPlace 類別參考資料

透過集合功能整理內容 你可以依據偏好儲存及分類內容。
Public Member Functions (公開成員函式) | 屬性
GMSPlace 類別參考資料

總覽

代表特定的實體地點。

GMSPlace 會封裝實體位置的相關資訊,包括其名稱、位置以及任何其他與之相關的資訊。此類別無法變更。

公開成員函式

(GMSPlaceOpenStatus)- isOpenAtDate:
 無法使用預設 init。
(GMSPlaceOpenStatus)- isOpen
 根據 openingHoursUTCOffsetMinutes 以及從 [NSDate date] 取得的目前日期和時間,計算出地點是否營業。

屬性

NSString * name
 地點名稱。
NSString * 地點 ID
 這個地點的地點 ID。
CLLocationCoordinate2D座標
 地點。
NSString * 電話號碼
 這個地點的電話號碼,採國際電話號碼格式,例如
NSString * formattedAddress
 地點的簡單字串。
浮點值評分
 根據使用者評論,這個地點的五星級評等。
GMSPlacesPriceLevel價格等級
 此地點的價格等級,以 0 到 4 之間的整數表示。
NSArray< NSString * > *類型
 這個地點的類型。
NSURL * 網站
 這個地點的網站。
NSAttributedString * 歸因
 這個地點的資料供應商歸因字串。
GMSPlaceViewportInfo *viewportInfo
 這個地點的建議可視區域。
NSArray< GMSAddressComponent * > *地址元件
 代表地點地址中各元件的 GMSAddressComponent 物件陣列。
GMSPlusCodeplusCode
 這個地點的 Plus Code 表示法。
GMSOpeningHours *營業時間
 這個地點的營業時間。
NSUInteger使用者評分總計
 代表這個地點的評論評分次數。
NSArray< GMSPlacePhotoMetadata * > *相片
 用來代表地點相片的 GMSPlacePhotoMetadata 物件陣列,
NSNumber * 世界標準時間停用時間
 地點的時區 (世界標準時間)。
GMSPlacesBusinessStatus
 地點的 GMSPlaceBusinessStatus
UIColor * 圖示背景色彩
 圖示的背景顏色,依地點類型而定,為圖示後方的檢視畫面上色。
NSURL * 圖示圖片網址
 根據「地點」類型輸入的網址,可用來擷取「地點」圖示的 NSData。
GMSBooleanPlaceAttribute外帶
 提供外帶體驗的 Place 屬性。
GMSBooleanPlaceAttribute廣告放送
 提供運送服務的 Place 屬性。
GMSBooleanPlaceAttributeDineIn
 提供現場用餐的 Place 屬性。
GMSBooleanPlaceAttribute路邊取貨
 提供店外取貨服務的 Place 屬性。

成員函式說明文件

- (GMSPlaceOpenStatus) isOpenAtDate: (NSDate *) 日期

無法使用預設 init。

根據 openingHoursUTCOffsetMinutesdate 來計算地點是否營業。

參數:
date用來判斷地點是否營業的參考時間點。
傳回:
GMSPlaceOpenStatusOpen 表示地點為開啟,GMSPlaceOpenStatusClosed 表示地點為關閉,GMSPlaceOpenStatusUnknown 表示未開啟。

根據 openingHoursUTCOffsetMinutes 以及從 [NSDate date] 取得的目前日期和時間,計算出地點是否營業。

傳回:
GMSPlaceOpenStatusOpen 表示地點為開啟,GMSPlaceOpenStatusClosed 表示地點為關閉,GMSPlaceOpenStatusUnknown 表示未開啟。

屬性說明文件

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

地點名稱。

- (NSString*) placeID [read, copy]

這個地點的地點 ID。

- (CLLocationCoordinate2D) 座標 [read, assign]

地點。

位置不一定是「地點」之中心,或任何特定入口或出口點,但某些可於「地點」地理範圍內任意選擇的點。

- (NSString*) 電話號碼 [read, copy]

這個地點的電話號碼,採國際電話號碼格式 (例如

包括開頭為「+」的國家/地區代碼。例如,Google 雪梨電話號碼是「+61 2 9374 4000」。

- (NSString*) formattedAddress [read, copy]

地點的簡單字串。

- (浮動) rating [read, assign]

根據使用者評論,這個地點的五星級評等。

評分範圍從 1.0 到 5.0。0.0 表示對這個地點沒評分 (例如因為評論者人數不足)。

- (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]

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

如果該地點的大小不明,可能會為零。

這會傳回適合顯示這個地點的大小。舉例來說,代表商店的 GMSPlace 物件可能具備相對小的可視區域,而代表國家/地區的 GMSPlace 物件,其可視區域可能會過大。

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

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

這些元件是用來擷取與地點地址相關的結構化資訊,例如尋找地點所在的城市。

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

- (GMSPlusCode*) plusCode [read, assign]

這個地點的 Plus Code 表示法。

- (GMSOpeningHours*) openingHours [read, assign]

這個地點的營業時間。

包括開啟狀態、訂閱期間和平日文字 (如果有的話)。

- (NSUInteger) userRatingsTotal [read, assign]

代表這個地點的評論評分次數。

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

用來代表地點相片的 GMSPlacePhotoMetadata 物件陣列,

- (NSNumber*) UTCOffsetMinutes [read, assign]

地點的時區 (世界標準時間)。

地點的 GMSPlaceBusinessStatus

- (UIColor*) iconBackgroundColor [read, assign]

圖示的背景顏色,依地點類型而定,為圖示後方的檢視畫面上色。

- (NSURL*) iconImageURL [read, assign]

根據「地點」類型輸入的網址,可用來擷取「地點」圖示的 NSData。

注意:網址連結不會過期,且圖片的長寬比可能因類型而異。

- (GMSBooleanPlaceAttribute) 外帶 [read, assign]

提供外帶體驗的 Place 屬性。

- (GMSBooleanPlaceAttribute) 放送 [read, assign]

提供運送服務的 Place 屬性。

- (GMSBooleanPlaceAttribute) dineIn [read, assign]

提供現場用餐的 Place 屬性。

提供店外取貨服務的 Place 屬性。