總覽
代表特定的實體地點。
GMSPlace 會封裝實體位置的相關資訊,包括其名稱、位置以及任何其他與之相關的資訊。此類別無法變更。
公開成員函式 | |
(GMSPlaceOpenStatus) | - isOpenAtDate: |
無法使用預設 init。 | |
(GMSPlaceOpenStatus) | - isOpen |
根據 openingHours 、UTCOffsetMinutes 以及從 [NSDate date] 取得的目前日期和時間,計算出地點是否營業。 | |
屬性 | |
NSString * | name |
地點名稱。 | |
NSString * | 地點 ID |
這個地點的地點 ID。 | |
CLLocationCoordinate2D | 座標 |
地點。 | |
NSString * | 電話號碼 |
這個地點的電話號碼,採國際電話號碼格式,例如 | |
NSString * | formattedAddress |
地點的簡單字串。 | |
浮點值 | 評分 |
根據使用者評論,這個地點的五星級評等。 | |
GMSPlacesPriceLevel | 價格等級 |
此地點的價格等級,以 0 到 4 之間的整數表示。 | |
NSArray< NSString * > * | 類型 |
這個地點的類型。 | |
NSURL * | 網站 |
這個地點的網站。 | |
NSAttributedString * | 歸因 |
這個地點的資料供應商歸因字串。 | |
GMSPlaceViewportInfo * | viewportInfo |
這個地點的建議可視區域。 | |
NSArray< GMSAddressComponent * > * | 地址元件 |
代表地點地址中各元件的 GMSAddressComponent 物件陣列。 | |
GMSPlusCode * | plusCode |
這個地點的 Plus Code 表示法。 | |
GMSOpeningHours * | 營業時間 |
這個地點的營業時間。 | |
NSUInteger | 使用者評分總計 |
代表這個地點的評論評分次數。 | |
NSArray< GMSPlacePhotoMetadata * > * | 相片 |
用來代表地點相片的 GMSPlacePhotoMetadata 物件陣列, | |
NSNumber * | 世界標準時間停用時間 |
地點的時區 (世界標準時間)。 | |
GMSPlacesBusinessStatus | |
地點的 GMSPlaceBusinessStatus 。 | |
UIColor * | 圖示背景色彩 |
圖示的背景顏色,依地點類型而定,為圖示後方的檢視畫面上色。 | |
NSURL * | 圖示圖片網址 |
根據「地點」類型輸入的網址,可用來擷取「地點」圖示的 NSData。 | |
GMSBooleanPlaceAttribute | 外帶 |
提供外帶體驗的 Place 屬性。 | |
GMSBooleanPlaceAttribute | 廣告放送 |
提供運送服務的 Place 屬性。 | |
GMSBooleanPlaceAttribute | DineIn |
提供現場用餐的 Place 屬性。 | |
GMSBooleanPlaceAttribute | 路邊取貨 |
提供店外取貨服務的 Place 屬性。 | |
GMSBooleanPlaceAttribute | 可預訂 |
此地點屬性表示觀光客很受歡迎。 | |
GMSBooleanPlaceAttribute | 放送中斷 |
標示「地點」的「地點屬性」提供早餐。 | |
GMSBooleanPlaceAttribute | 供應午餐 |
指出地點供應午餐的「地點屬性」。 | |
GMSBooleanPlaceAttribute | servesDinner |
表示地點供應晚餐的「屬性」屬性。 | |
GMSBooleanPlaceAttribute | servesBeer |
「地點屬性」表示地點提供啤酒。 | |
GMSBooleanPlaceAttribute | 供應酒 |
表示「地點」供應的「地點屬性」。 | |
GMSBooleanPlaceAttribute | servesBrunch |
表示地點提供早午餐的 Place Attribute。 | |
GMSBooleanPlaceAttribute | 供應素食食物 |
Place Attribute 表示地點供應素食餐點。 | |
GMSBooleanPlaceAttribute | 輪椅無障礙服務入口 |
「地點屬性」 表示 地點為入口的無障礙設施。 |
成員函式說明文件
- (GMSPlaceOpenStatus) isOpenAtDate: | (NSDate *) | 日期 |
無法使用預設 init。
根據 openingHours
、UTCOffsetMinutes
和 date
來計算地點是否營業。
- 參數:
-
日期 用來判斷地點是否營業的參考時間點。
- 傳回:
- GMSPlaceOpenStatusOpen 表示地點為開啟,GMSPlaceOpenStatusClosed 表示地點為關閉,GMSPlaceOpenStatusUnknown 表示未開啟。
根據 openingHours
、UTCOffsetMinutes
以及從 [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] |
- (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] |
地點的時區 (世界標準時間)。
- (GMSPlacesBusinessStatus) businessStatus [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 屬性。
- (GMSBooleanPlaceAttribute) curbsidePickup [read, assign] |
提供店外取貨服務的 Place 屬性。
- (GMSBooleanPlaceAttribute) 可預訂 [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] |
表示地點提供早午餐的 Place Attribute。
- (GMSBooleanPlaceAttribute) servesVegetarianFood [read, assign] |
Place Attribute 表示地點供應素食餐點。
- (GMSBooleanPlaceAttribute) wheelcourseAccessibleEntrance [read, assign] |
「地點屬性」 表示 地點為入口的無障礙設施。