GMSPlace 类参考

GMSPlace 类参考文档

概览

表示特定物理地点。

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

公开成员函数

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

属性

NSString * name
 该地点的名称。
NSString * 地点 ID
 此地点的地点 ID。
CLLocationCoordinate2D坐标
 地点的位置。
NSString * 电话号码
 此地点的电话号码(采用国际电话号码格式),例如
NSString * formattedAddress
 地点的简单字符串。
浮点数评分
 根据用户评价得出的此地点的 5 星评分。
GMSPlacesPriceLevel价格水平
 此地点的价格水平,以 0 到 4 之间的整数表示。
NSArray< NSString * > * 类型
 此地点的类型。
NS网址 * 网站
 此地点的网站。
NSAttributedString * 归因
 此地点的数据提供商归因字符串。
GMSPlaceViewportInfoviewportInfo
 建议此地点的视口。
NSArray< GMSAddressComponent * > * addressComponents
 GMSAddressComponent 对象数组,表示地点地址中的组成部分。
GMSPlusCodeplusCode
 此地点的 Plus Code 表示法。
GMSOpeningHoursopeningHours(营业时间)
 此地点的正常营业时间。
NSUInteger用户评分总计
 表示这个地点的评分数量。
NSArray< GMSPlacePhotoMetadata * > * 照片
 GMSPlacePhotoMetadata 对象数组,表示地点的照片。
NSNumber * UTCOffsetMinutes(世界协调时间偏移量)
 地点的时区 UTC 偏移量(以分钟为单位)。
GMSPlacesBusinessStatus商家状态
 地点的 GMSPlaceBusinessStatus
UIColor * iconBackgroundColor
 图标的背景颜色(根据地点类型),用于为图标后面的视图着色。
NS网址 * iconImage网址
 按地点类型输入的网址,可用于检索地点图标的 NSData。
GMSBooleanPlaceAttribute外卖
 提供外卖体验的“地点”属性。
GMSBooleanPlaceAttribute配送
 配送服务的属性。
GMSBooleanPlaceAttributedineIn
 提供用餐体验的属性。
GMSBooleanPlaceAttributecurbsidePickup
 “路边自提”服务的地点属性。
GMSBooleanPlaceAttribute可预订
 地点属性表示地点深受游客欢迎。
GMSBooleanPlaceAttributeservesBreakfast
 地点属性,指示地点供应早餐。
GMSBooleanPlaceAttributeservesLunch
 地点属性,指示地点供应午餐。
GMSBooleanPlaceAttributeservesDinner
 地点属性,指示地点供应晚餐。
GMSBooleanPlaceAttribute可投放啤酒
 “地点属性”表示地点供应啤酒。
GMSBooleanPlaceAttributeservesWine
 “地点属性”表示地点供应葡萄酒。
GMSBooleanPlaceAttributeservesBrunch
 “地点属性”表示地点供应早午餐。
GMSBooleanPlaceAttributeservesVegetarianFood
 地点属性,指示供应素食的地点。
GMSBooleanPlaceAttribute轮椅通道门票
 地点属性,指明地点在入口处有无障碍设施。

成员函数文档

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

默认 init 不可用。

根据 openingHoursUTCOffsetMinutesdate 计算某个地点是否营业。

参数:
date用于确定地点是否营业的参考时间点。
返回
如果该地点的营业状态,则会显示 GMSPlaceOpenStatusOpen;如果该地点的营业状态未知,则显示 GMSPlaceOpenStatusClosed。

根据openingHoursUTCOffsetMinutes以及从[NSDate date]获取的当前日期和时间,计算某个地点是否营业。

返回
如果该地点的营业状态,则会显示 GMSPlaceOpenStatusOpen;如果该地点的营业状态未知,则显示 GMSPlaceOpenStatusClosed。

属性说明

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

该地点的名称。

- (NSString*) placeID [read, copy]

此地点的地点 ID。

- (CLLocationCoordinate2D) 坐标 [read, assign]

地点的位置。

该位置不一定是地点的中心,或者任何特定的入口或出口点,而是某个地点任意范围内的任意选择点。

- (NSString*) phoneNumber [read, copy]

此地点的电话号码(采用国际电话号码格式),即

(包含前缀为“+”的国家/地区代码)。例如,Google Sydney 的电话号码是“+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 的形式提供,其中可能包含指向每个提供程序的网站的超链接。

一般情况下,如果显示来自 GMSPlace 的数据,则必须向用户显示这些地点(如 Places SDK 服务条款中所述)。

- (GMSPlaceViewportInfo*) viewportInfo [read, assign]

建议此地点的视口。

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

这将返回一个适合显示此地点的尺寸的视口。例如,代表商店的 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]

地点的时区 UTC 偏移量(以分钟为单位)。

地点的 GMSPlaceBusinessStatus

- (UIColor*) iconBackgroundColor [read, assign]

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

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

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

注意:网址链接不会失效,图片大小宽高比可能会因类型而异。

- (GMSBooleanPlaceAttribute) 导出 [read, assign]

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

- (GMSBooleanPlaceAttribute) 投放 [read, assign]

配送服务的属性。

- (GMSBooleanPlaceAttribute) dineIn [read, assign]

提供用餐体验的属性。

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

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

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

地点属性,指示地点供应早餐。

地点属性,指示地点供应午餐。

地点属性,指示地点供应晚餐。

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

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

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

地点属性,指示供应素食的地点。

地点属性,指明地点在入口处有无障碍设施。