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
 “路边自提”服务的地点属性。

成员函数文档

- (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 用于用餐。

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