GMSPlace 类参考

GMSPlace 类参考文档

概览

表示特定实际地点。

GMSPlace封装了关于物理位置的信息,包括其名称、位置和我们可能拥有的任何其他相关信息。此类是不可变的。

公开成员函数

(GMSPlaceOpenStatus)- isOpenAtDate:
 默认 init 不可用。
(GMSPlaceOpenStatus)- isOpen
 根据 openingHoursUTCOffsetMinutes 以及从 [NSDate date] 获取的当前日期和时间来计算地点是否营业。

属性

NSString * name
 地点的名称。
NSString * 地点 ID
 此地点的地点 ID。
CLLocationCoordinate2D坐标
 地点的位置。
NSString * 电话号码
 此地点的电话号码,采用国际格式,例如
NSString * formattedAddress
 地点的地址,采用简单的字符串形式。
浮点数评分
 根据用户评价得出的此地点的 5 星评分。
GMSPlacesPriceLevelpriceLevel
 此地点的价格水平,以 0 到 4 之间的整数表示。
NSArray< NSString * > *类型
 此地点的类型。
NS网址 * 网站
 此地点的网站。
NSAttributedString * 归因
 此地点的数据提供方归因字符串。
GMSPlaceViewportInfo*viewportInfo
 对此地点建议的视口。
NSArray< GMSAddressComponent * > *addressComponents
 代表地点地址组成部分的 GMSAddressComponent 对象的数组。
GMSPlusCode *plusCode
 Plus 代码表示此地点的位置。
GMSOpeningHours营业时间
 此地点的“营业时间”信息。
NSUInteger用户评分总计
 表示构成此地点评分的评价数量。
NSArray< GMSPlacePhotoMetadata * > *照片
 代表地点照片的 GMSPlacePhotoMetadata 对象数组。
NSNumber * 世界协调时间 (UTC)
 地点的时区世界协调时间 (UTC) 偏移量(以分钟为单位)。
GMSPlacesBusinessStatusbusinessStatus
 地点的 GMSPlaceBusinessStatus
UIColor * iconBackgroundColor
 根据地点类型的图标背景颜色,用于为图标后面的视图着色。
NS网址 * iconImage网址
 按地点类型划分的网址,可用于检索地点图标的 NSData。
GMSBooleanPlaceAttribute导出
 提供外卖体验的地点属性。
GMSBooleanPlaceAttribute配送
 配送服务的“地点属性”。
GMSBooleanPlaceAttributedineIn
 Place Attribute 用于用餐。
GMSBooleanPlaceAttributecurbsidePickup
 “路边自提”服务的地点属性。
GMSBooleanPlaceAttribute可预订
 “地点属性”表示该地点深受游客欢迎。
GMSBooleanPlaceAttributeservesBreakfast
 “地点属性”表示地点供应早餐。
GMSBooleanPlaceAttributeservesLunch
 “地点属性”表示地点供应午餐。
GMSBooleanPlaceAttributeservesDinner
 “地点属性”表示地点供应晚餐。
GMSBooleanPlaceAttribute供应啤酒
 “地点属性”表示地点供应啤酒。
GMSBooleanPlaceAttributeservesWine
 “地点属性”表示地点供应葡萄酒。
GMSBooleanPlaceAttribute服务早午餐
 “地点属性”表示地点供应早午餐。
GMSBooleanPlaceAttribute服务素食食品
 “地点属性”表示地点供应素食。
GMSBooleanPlaceAttribute无障碍入口
 “地点属性”表示入口处的无障碍入口。

成员函数文档

- (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*) 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> 中载述的任何类型。

- (NS网址*) 网站 [read, copy]

此地点的网站。

- (NSAttributedString*) 提供方 [read, copy]

此地点的数据提供方归因字符串。

这些属性以 NSAttributedString 的形式提供,可能包含指向每个提供程序网站的超链接。

如 Places SDK 服务条款中所述,一般情况下,如果显示此 GMSPlace 中的数据,必须向用户显示这些变量。

- (GMSPlaceViewportInfo*) viewportInfo [read, assign]

对此地点建议的视口。

如果不知道地点的大小,则可能为 nil。

系统会返回适合显示此地点的大小的视口。例如,表示商店的 GMSPlace 对象可能具有相对较小的视口,而代表国家/地区的 GMSPlace 对象可能具有非常大的视口。

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

代表地点地址组成部分的 GMSAddressComponent 对象的数组。

提供这些组件的目的在于提取地点地址的结构化信息,例如:查找地点所在的城市。

这些组件不应用于地址格式设置。如果需要特定格式的地址,请使用 formattedAddress 属性,此属性可提供本地化格式的地址。

- (GMSPlusCode*) plusCode [read, assign]

Plus 代码表示此地点的位置。

- (GMSOpeningHours*) 开始营业时间 [read, assign]

此地点的“营业时间”信息。

包括营业状态、经期和工作日文本(如果有)。

- (NSUInteger) userRatingsTotal [read, assign]

表示构成此地点评分的评价数量。

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

代表地点照片的 GMSPlacePhotoMetadata 对象数组。

- (NSNumber*) UTCOffsetMinutes [read, assign]

地点的时区世界协调时间 (UTC) 偏移量(以分钟为单位)。

地点的 GMSPlaceBusinessStatus

- (UIColor*) iconBackgroundColor [read, assign]

根据地点类型的图标背景颜色,用于为图标后面的视图着色。

- (NS网址*) iconImage网址 [read, assign]

按地点类型划分的网址,可用于检索地点图标的 NSData。

注意:网址链接不会过期,图片尺寸宽高比可能会因类型而异。

- (GMSBooleanPlaceAttribute) 导出 [read, assign]

提供外卖体验的地点属性。

- (GMSBooleanPlaceAttribute) delivery [read, assign]

配送服务的“地点属性”。

- (GMSBooleanPlaceAttribute) dineIn [read, assign]

Place Attribute 用于用餐。

“路边自提”服务的地点属性。

- (GMSBooleanPlaceAttribute) 可预留 [read, assign]

“地点属性”表示该地点深受游客欢迎。

“地点属性”表示地点供应早餐。

“地点属性”表示地点供应午餐。

“地点属性”表示地点供应晚餐。

“地点属性”表示地点供应啤酒。

“地点属性”表示地点供应葡萄酒。

“地点属性”表示地点供应早午餐。

“地点属性”表示地点供应素食。

“地点属性”表示入口处的无障碍入口。