GMSPlace 類別參考資料

GMSPlace 類別參考資料

總覽

代表特定實體地點。

GMSPlace 會封裝實體據點的相關資訊,包括其名稱、所在位置,以及我們可能會有的所有相關資訊。此類別無法變更。

公開成員函式

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

屬性

NSString * name
 地點名稱。
NSString * PlaceID
 這個地點的地點 ID。
CLLocationCoordinate2D座標
 地點的位置。
NSString * 電話號碼
 此地點的電話號碼 (國際格式),例如:
NSString * formattedAddress
 地點的地址,以簡單字串表示。
浮動值評分
 這個地點的評分 (滿分為 5 星級),
GMSPlacesPriceLevelpriceLevel
 這個地點的價格級別,以 0 到 4 之間的整數表示。
NSArray< NSString * > * 類型
 這個地點的類型。
NSURL * 網站
 這個地點的網站。
NSAttributedString * 歸因
 這個地點的資料供應商歸因字串。
GMSPlaceViewportInfoviewportInfo
 這個地點的推薦可視區域。
NSArray< GMSAddressComponent * > * addressComponents
 GMSAddressComponent 物件陣列,表示地點地址中的元件。
GMSPlusCodeplusCode
 這個地點的地點加號。
GMSOpeningHoursopeningHours
 這個地點的正常營業時間。
NSUIntegeruserRatingsTotal
 代表這個地點獲得的評分數量。
NSArray< GMSPlacePhotoMetadata * > * 相片
 代表地點相片的 GMSPlacePhotoMetadata 物件陣列。
NSNumber * UTCOffsetMinutes
 地點的時區 UTC,以分鐘為單位。
GMSPlacesBusinessStatusbusinessStatus
 地點的 GMSPlaceBusinessStatus
UIColor * 圖示背景顏色
 根據地點類型顯示的圖示背景顏色,為圖示背後的檢視畫面上色。
NSURL * 圖示圖片網址
 以地點類型為依據的網址,可用來擷取地點圖示的 NSData。
GMSBooleanPlaceAttribute匯出
 放置屬性屬性,提供外帶服務。
GMSBooleanPlaceAttribute廣告放送
 交付服務的屬性。
GMSBooleanPlaceAttributedineIn
 為用餐活動安排地點屬性。
GMSBooleanPlaceAttribute店外取貨
 設定店外取貨服務的屬性。
GMSBooleanPlaceAttribute可預訂
 「地點屬性」指出某個地點受旅客歡迎。
GMSBooleanPlaceAttributeservesBreakfast
 「地點屬性」指出早餐的位置。
GMSBooleanPlaceAttribute亦即放送午餐
 「地點屬性」表示服務供應午餐。
GMSBooleanPlaceAttributeservesDinner
 「地點屬性」代表晚餐供應。
GMSBooleanPlaceAttribute
 「地點屬性」表示提供啤酒。
GMSBooleanPlaceAttributeservesWine
 「地點屬性」代表供應葡萄酒的地點。
GMSBooleanPlaceAttribute
 「地點屬性」表示提供早午餐。
GMSBooleanPlaceAttributeservesVegetarianFood
 「地點屬性」代表供應素食餐點的地點。
GMSBooleanPlaceAttribute輪椅無障礙
 「地點屬性」代表入口處有輪椅。

成員函式說明文件

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

預設 init 無法使用。

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

參數:
日期用於判斷地點是否營業的參考時間點。
傳回:
如果地點營業,而 GMSPlaceOpenStatusOpen (如果地點封閉,則 GMSPlaceOpenStatusClosed;如果營業狀態不明,GMSPlaceOpenStatusUnknown)。

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

傳回:
如果地點營業,而 GMSPlaceOpenStatusOpen (如果地點封閉,則 GMSPlaceOpenStatusClosed;如果營業狀態不明,GMSPlaceOpenStatusUnknown)。

資源說明文件

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

地點名稱。

- (NSString*) placeID [read, copy]

這個地點的地點 ID。

- (CLLocationCoordinate2D) 座標 [read, assign]

地點的位置。

地點不一定是「地點」中心或特定特定進入點或終點,不過有些地點會優先於「地點」的地理範圍內。

- (NSString*) phoneNumber [read, copy]

此地點的電話號碼 (國際格式),例如

包括前置字串為「+」的國家/地區代碼。舉例來說,Google 雪梨 的電話號碼為「+61 2 9374 4000」。

- (NSString*) formattedAddress [read, copy]

地點的地址,以簡單字串表示。

- (浮動) 評分 [read, assign]

這個地點的評分 (滿分為 5 星級),

評分範圍: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]

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

這些 ID 會以 NSAttributedString 的形式提供,其中可能包含每個供應商網站的超連結。

一般來說,如果顯示這個 GMSPlace 的資料,必須向使用者顯示這些資料,如《Places SDK 服務條款》所述。

- (GMSPlaceViewportInfo*) viewportInfo [read, assign]

這個地點的推薦可視區域。

如果地點大小不明,可能為空值。

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

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

GMSAddressComponent 物件陣列,表示地點地址中的元件。

提供這些元件的目的是擷取地點地址的結構化資訊,例如找出某個地點的城市。

這些元件不應用於地址格式。如果格式化地址是必填資訊,請使用 formattedAddress 屬性,提供本地化格式的地址。

- (GMSPlusCode*) plusCode [read, assign]

這個地點的地點加號。

- (GMSOpeningHours*) openingHours [read, assign]

這個地點的正常營業時間資訊。

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

- (NSUInteger) userRatingsTotal [read, assign]

代表這個地點獲得的評分數量。

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

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

- (NSNumber*) UTCOffsetMinutes [read, assign]

地點的時區 UTC,以分鐘為單位。

地點的 GMSPlaceBusinessStatus

- (UIColor*) iconBackgroundColor [read, assign]

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

- (NSURL*) iconImageURL [read, assign]

以地點類型為依據的網址,可用來擷取地點圖示的 NSData。

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

- (GMSBooleanPlaceAttribute) 匯出 [read, assign]

放置屬性屬性,提供外帶服務。

- (GMSBooleanPlaceAttribute) delivery [read, assign]

交付服務的屬性。

- (GMSBooleanPlaceAttribute) dineIn [read, assign]

為用餐活動安排地點屬性。

設定店外取貨服務的屬性。

「地點屬性」指出某個地點受旅客歡迎。

「地點屬性」指出早餐的位置。

「地點屬性」表示服務供應午餐。

「地點屬性」代表晚餐供應。

「地點屬性」表示提供啤酒。

「地點屬性」代表供應葡萄酒的地點。

「地點屬性」表示提供早午餐。

「地點屬性」代表供應素食餐點的地點。

「地點屬性」代表入口處有輪椅。