GMSPlace 类参考

GMSPlace 类参考

概览

表示特定的实际地点。

GMSPlace封装有关实际位置的信息,包括其名称、位置以及我们可能掌握的有关它的任何其他信息。此类是不可变的。

公开成员函数

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

属性

NSString * name
 地点的名称。
NSString * placeID
 此地点的地点 ID。
CLLocationCoordinate2D坐标
 地点的位置。
NSString * phoneNumber
 此地点的电话号码,采用国际电话号码格式,例如
NSString * formattedAddress
 地点的地址(简单字符串形式)。
float rating
 根据用户评价,给此地点的 5 星评分。
GMSPlacesPriceLevelpriceLevel
 此地点的价格水平,为 0 到 4 之间的整数。
NSArray< NSString * > * 类型
 此地点的类型。
NS网址 * 网站
 此地点的网站。
NSAttributedString * 提供方说明
 此地点的数据提供方属性字符串。
GMSPlaceViewportInfoviewportInfo
 此地点的推荐视口。
NSArray< GMSAddressComponent * > * addressComponents
 GMSAddressComponent 对象数组,表示地点地址中的组成部分。
GMSPlusCodeplusCode
 此地点的位置的 Plus 代码表示法。
GMSOpeningHoursopeningHours
 此地点的正常营业时间信息。
GMSOpeningHourscurrentOpeningHours
 返回此地点未来 7 天的营业时间。
NSArray< GMSOpeningHours * > * secondaryOpeningHours
 返回此地点在未来 7 天内的次要营业时间的数组。
NSUIntegeruserRatingsTotal
 表示此地点的评分中包含了多少条评价。
NSArray< GMSPlacePhotoMetadata * > * 照片
 GMSPlacePhotoMetadata 对象数组,表示地点的照片。
NSNumber * UTCOffsetMinutes
 地点的时区世界协调时间 (UTC) 偏移量(以分钟为单位)。
GMSPlacesBusinessStatusbusinessStatus
 地点的 GMSPlaceBusinessStatus
NSString * editorialSummary
 返回此地点的编辑摘要。
UIColor * iconBackgroundColor
 根据地点类型显示的图标背景颜色,用于为图标背后的视图着色。
NS网址 * iconImageURL
 根据地点类型划分的网址,可用于检索地点图标的 NSData。
GMSBooleanPlaceAttribute外带
 提供外卖体验的地点属性。
GMSBooleanPlaceAttribute送货
 配送服务的地点属性。
GMSBooleanPlaceAttributedineIn
 “用餐体验”地点属性。
GMSBooleanPlaceAttributecurbsidePickup
 路边自提服务的地点属性。
GMSBooleanPlaceAttribute可预订
 地点属性,用于表示地点受游客欢迎。
GMSBooleanPlaceAttributeservesBreakfast
 地点属性,用于表示地点供应早餐。
GMSBooleanPlaceAttributeservesLunch
 “地点”属性,用于表示地点供应午餐。
GMSBooleanPlaceAttributeservesDinner
 地点属性,表示供应晚餐的地点。
GMSBooleanPlaceAttributeservesBeer
 地点属性,用于表示地点供应啤酒。
GMSBooleanPlaceAttributeservesWine
 地点属性,表示供应葡萄酒的地点。
GMSBooleanPlaceAttributeservesBrunch
 “地点”属性,表示地点供应早午餐。
GMSBooleanPlaceAttributeservesVegetarianFood
 地点属性,用于表示供应素食的地点。
GMSBooleanPlaceAttributewheelchairAccessibleEntrance
 地点属性,用于表示地点在入口处设有无障碍设施。

成员函数文档

- (GMSPlaceOpenStatus) isOpenAtDate (NSDate *) 日期

默认 init 不可用。

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

参数:
date用于确定地点是否营业的参考时间点。
返回
如果地点处于营业状态,则为 GMSPlaceOpenStatusOpen;如果地点已关闭,则为 GMSPlaceOpenStatusClosed;如果该地点营业状态未知,则为 GMSPlaceOpenStatusUnknown。
注意:
已弃用。此方法已废弃,取而代之的是 GMSPlacesClient::isOpenAtDate:place:date:callback</ code> and will be removed in a future release.

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

返回
如果地点处于营业状态,则为 GMSPlaceOpenStatusOpen;如果地点已关闭,则为 GMSPlaceOpenStatusClosed;如果该地点营业状态未知,则为 GMSPlaceOpenStatusUnknown。
注意:
已弃用。此方法已被弃用,取而代之的是 GMSPlacesClient::isOpen:place:callback,并将在未来的版本中移除。

属性说明

- (NSString*) name [read, copy]

地点的名称。

- (NSString*) placeID [read, copy]

此地点的地点 ID。

- (CLLocationCoordinate2D) 坐标 [read, assign]

地点的位置。

该位置未必是地方的中心,也不是任何特定的入口或出口,而是在其地理范围内任意选择的点。

- (NSString*) phoneNumber [read, copy]

此地点的电话号码,采用国际电话号码格式,例如

包括以“+”为前缀的国家/地区代码。例如,Google 悉尼的电话号码是“+61 2 9374 4000”。

- (NSString*) formattedAddress [read, copy]

地点的地址(简单字符串形式)。

-(浮点数)rating [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*) attributions [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*) openingHours [read, assign]

此地点的正常营业时间信息。

包括营业状态、时段和工作日文字(如果有)。

- (GMSOpeningHours*) currentOpeningHours [read, assign]

返回此地点未来 7 天的营业时间。

该时间段从请求之日的零点开始,到六天后的晚上 11:59 结束。

GMSOpeningHours上的GMSPlaceSpecialDay条目将仅针对GMSPlace currentOpeningHoursGMSPlace secondaryOpeningHours显示。

- (NSArray<GMSOpeningHours *>*) secondaryOpeningHours [read, copy]

返回此地点在未来 7 天内的次要营业时间的数组。

次要营业时间与商家的主要营业时间不同。例如,餐馆可以将免下车时间或送餐时间指定为次要营业时间。如需了解不同类型的次要营业时间,请参阅 GMSPlaceHoursType

GMSOpeningHours上的GMSPlaceSpecialDay条目将仅针对GMSPlace currentOpeningHoursGMSPlace secondaryOpeningHours显示。

- (NSUInteger) userRatingsTotal [read, assign]

表示此地点的评分中包含了多少条评价。

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

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

- (NSNumber*) UTCOffsetMinutes [read, assign]

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

地点的 GMSPlaceBusinessStatus

- (NSString*) editorialSummary [read, copy]

返回此地点的编辑摘要。

- (UIColor*) iconBackgroundColor [read, assign]

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

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

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

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

- (GMSBooleanPlaceAttribute) takeout [read, assign]

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

- (GMSBooleanPlaceAttribute) delivery [read, assign]

配送服务的地点属性。

- (GMSBooleanPlaceAttribute) dineIn [read, assign]

“用餐体验”地点属性。

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

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

地点属性,用于表示地点受游客欢迎。

地点属性,用于表示地点供应早餐。

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

地点属性,表示供应晚餐的地点。

地点属性,用于表示地点供应啤酒。

地点属性,表示供应葡萄酒的地点。

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

地点属性,用于表示供应素食的地点。

地点属性,用于表示地点在入口处设有无障碍设施。