概览
表示特定的实际地点。
GMSPlace 包含关于某个实际位置的信息,包括其名称、位置以及我们可能掌握的关于该位置的任何其他信息。此类是不可变的。
公开成员函数 | |
(GMSPlaceOpenStatus) | - isOpenAtDate:: |
默认 init 不可用。 | |
(GMSPlaceOpenStatus) | - isOpen |
根据 openingHours 、UTCOffsetMinutes 以及从 [NSDate date] 获取的当前日期和时间,计算某个地点是否营业。 | |
属性 | |
NSString * | name |
地点的名称。 | |
NSString * | placeID |
此地点的地点 ID。 | |
CLLocationCoordinate2D | 坐标 |
地点的位置。 | |
NSString * | phoneNumber |
此地点的电话号码(采用国际电话号码格式,例如 ) | |
NSString * | formattedAddress |
地点地址(以简单字符串表示)。 | |
浮点数 | 评分 |
根据用户评价为此地点给出的 5 星评分。 | |
NSArray<GMSPlaceReview * >* | 评价 |
GMSPlaceReview 对象数组,表示用户对该地点的评价。 | |
GMSPlacesPriceLevel | priceLevel |
此地点的价格水平,以 0 到 4 之间的整数表示。 | |
NSArray<NSString * >* | 类型 |
此地点的类型。 | |
NS网址 * | 网站 |
此地点的网站。 | |
NSAttributedString * | 归因 |
此地点的数据提供商归因字符串。 | |
GMSPlaceViewportInfo * | viewportInfo |
此地点的推荐视口。 | |
NSArray<GMSAddressComponent * >* | addressComponents |
GMSAddressComponent 对象数组,表示地点地址中的组成部分。 | |
GMSPlusCodeGMSPlusCode * | plusCode |
此地点位置的 Plus Code 表示形式。 | |
GMSOpeningHours * | openingHours |
此地点的正常营业时间信息。 | |
GMSOpeningHours * | currentOpeningHours |
返回此地点未来 7 天的营业时间。 | |
NSArray<GMSOpeningHours * >* | secondaryOpeningHours |
返回此地点未来 7 天内的次要营业时间。 | |
NSUInteger | userRatingsTotal |
表示对此地点的评分有多少条评价。 | |
NSArray<GMSPlacePhotoMetadata * >* | 照片 |
GMSPlacePhotoMetadata 对象数组,表示地点的照片。 | |
NSNumber * | UTCOffsetMinutes |
地点的时区偏移量(以分钟为单位)。 | |
GMSPlacesBusinessStatus | businessStatus |
地点的 GMSPlaceBusinessStatus 。 | |
NSString * | editorialSummary |
返回此地点的编辑摘要。 | |
UIColor * | iconBackgroundColor |
图标的背景颜色,基于地点类型,用于为图标后面的视图着色。 | |
NS网址 * | iconImageURL |
基于地点类型的网址,可用于检索地点图标的 NSData。 | |
GMSBooleanPlaceAttribute | 导出 |
外卖体验的地点属性。 | |
GMSBooleanPlaceAttribute | 送货 |
配送服务的地点属性。 | |
GMSBooleanPlaceAttribute | dineIn |
用餐体验的地点属性。 | |
GMSBooleanPlaceAttribute | curbsidePickup |
路边自提服务的地点属性。 | |
GMSBooleanPlaceAttribute | 可预订 |
“地点属性”,用于表明该地点受游客欢迎。 | |
GMSBooleanPlaceAttribute | servesBreakfast |
“地点”属性,用于表示供应早餐的地点。 | |
GMSBooleanPlaceAttribute | servesLunch |
表示地点供应午餐的地点属性。 | |
GMSBooleanPlaceAttribute | servesDinner |
指示供应晚餐的地点属性。 | |
GMSBooleanPlaceAttribute | servesBeer |
用于指明供应啤酒的地点的属性。 | |
GMSBooleanPlaceAttribute | servesWine |
指示供应葡萄酒的地点属性。 | |
GMSBooleanPlaceAttribute | servesBrunch |
指示供应早午餐的地点属性。 | |
GMSBooleanPlaceAttribute | servesVegetarianFood |
表示地点供应素食的地点属性。 | |
GMSBooleanPlaceAttribute | wheelchairAccessibleEntrance |
表示地点在入口处有无障碍设施的地点属性。 |
成员函数文档
- (GMSPlaceOpenStatus) isOpenAtDate:: | (NSDate *) | 日期 |
默认 init 不可用。
根据 openingHours
、UTCOffsetMinutes
和 date
计算某个地点是否营业。
- 参数:
-
date 用于确定地点是否营业的参考时间点。
- 返回:
- GMSPlaceOpenStatusOpen(如果地点已营业)、GMSPlaceOpenStatusClosed(如果地点已关闭)和 GMSPlaceOpenStatusUnknown(如果地点的营业状态未知)。
- 注意:
- 此 API 已弃用。此方法已废弃,取而代之的是
GMSPlacesClient::isOpenAtDate:place:date:callback</ code> and will be removed in a future release.
根据 openingHours
、UTCOffsetMinutes
以及从 [NSDate date]
获取的当前日期和时间,计算某个地点是否营业。
- 返回:
- GMSPlaceOpenStatusOpen(如果地点已营业)、GMSPlaceOpenStatusClosed(如果地点已关闭)和 GMSPlaceOpenStatusUnknown(如果地点的营业状态未知)。
- 注意:
- 此 API 已弃用。此方法已被弃用,取而代之的是
GMSPlacesClient::isOpen:place:callback
,并将在未来的版本中移除。
属性说明
- (NSString*) name [read, copy] |
地点的名称。
- (NSString*) placeID [read, copy] |
此地点的地点 ID。
地点的位置。
该位置不一定是该“地方”的中心或任何特定的入口或出口,而是在该“地方”的地理范围内任意选定的点。
- (NSString*) phoneNumber [read, copy] |
此地点的电话号码,采用国际电话号码格式,例如
包含带“+”前缀的国家/地区代码。例如,Google 悉尼分公司的电话号码是“+61 2 9374 4000”。
- (NSString*) formattedAddress [read, copy] |
地点地址(以简单字符串表示)。
-(浮点数)rating [read, assign] |
根据用户评价为此地点给出的 5 星评分。
评分范围为 1.0 到 5.0。0.0 表示我们没有对此地点进行评分(例如,因为对此地点进行评论的用户不足)。
- (NSArray<GMSPlaceReview *>*) 评论 [read, copy] |
GMSPlaceReview
对象数组,表示用户对该地点的评价。
- (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] |
- (NSArray<GMSAddressComponent *>*) addressComponents [read, copy] |
GMSAddressComponent
对象数组,表示地点地址中的组成部分。
提供这些组件的目的是提取有关地点地址的结构化信息,例如,查找地点所在的城市。
这些组成部分不应用于设置地址格式。如果需要格式化的地址,请使用 formattedAddress
属性,此属性会提供已本地化格式的地址。
- (GMSPlusCode*) plusCode [read, assign] |
此地点位置的 Plus Code 表示形式。
- (GMSOpeningHours*) openingHours [read, assign] |
此地点的正常营业时间信息。
包括营业状态、时段和工作日文本(如果有)。
- (GMSOpeningHours*) currentOpeningHours [read, assign] |
返回此地点未来 7 天的营业时间。
该时间段从请求日期的午夜开始,到六天后晚上 11:59 结束。
GMSOpeningHours
上的 GMSPlaceSpecialDay
个条目仅会针对 GMSPlace
currentOpeningHours
和 GMSPlace
secondaryOpeningHours
显示。
- (NSArray<GMSOpeningHours *>*) secondaryOpeningHours [read, copy] |
返回此地点未来 7 天内的次要营业时间。
次要营业时间与商家的主要营业时间不同。例如,餐馆可以将免下车营业时间或送餐时间指定为辅助营业时间。如需了解不同类型的次要营业时间,请参阅 GMSPlaceHoursType
。
GMSOpeningHours
上的 GMSPlaceSpecialDay
个条目仅会针对 GMSPlace
currentOpeningHours
和 GMSPlace
secondaryOpeningHours
显示。
- (NSUInteger) userRatingsTotal [read, assign] |
表示对此地点的评分有多少条评价。
- (NSArray<GMSPlacePhotoMetadata *>*) 照片 [read, copy] |
GMSPlacePhotoMetadata
对象数组,表示地点的照片。
- (NSNumber*) UTCOffsetMinutes [read, assign] |
地点的时区偏移量(以分钟为单位)。
- (GMSPlacesBusinessStatus) businessStatus [read, assign] |
地点的 GMSPlaceBusinessStatus
。
- (NSString*) editorialSummary [read, copy] |
返回此地点的编辑摘要。
- (UIColor*) iconBackgroundColor [read, assign] |
图标的背景颜色,基于地点类型,用于为图标后面的视图着色。
- (NS网址*) iconImageURL [read, assign] |
基于地点类型的网址,可用于检索地点图标的 NSData。
注意:网址链接不会过期,且图片大小宽高比可能会因类型而异。
- (GMSBooleanPlaceAttribute) 导出 [read, assign] |
外卖体验的地点属性。
- (GMSBooleanPlaceAttribute) 投放 [read, assign] |
配送服务的地点属性。
- (GMSBooleanPlaceAttribute) dineIn [read, assign] |
用餐体验的地点属性。
- (GMSBooleanPlaceAttribute) curbsidePickup [read, assign] |
路边自提服务的地点属性。
- (GMSBooleanPlaceAttribute) reservable [read, assign] |
“地点属性”,用于表明该地点受游客欢迎。
- (GMSBooleanPlaceAttribute) servesBreakfast [read, assign] |
“地点”属性,用于表示供应早餐的地点。
- (GMSBooleanPlaceAttribute) servesLunch [read, assign] |
表示地点供应午餐的地点属性。
- (GMSBooleanPlaceAttribute) servesDinner [read, assign] |
指示供应晚餐的地点属性。
- (GMSBooleanPlaceAttribute) servesBeer [read, assign] |
用于指明供应啤酒的地点的属性。
- (GMSBooleanPlaceAttribute) servesWine [read, assign] |
指示供应葡萄酒的地点属性。
- (GMSBooleanPlaceAttribute) servesBrunch [read, assign] |
指示供应早午餐的地点属性。
- (GMSBooleanPlaceAttribute) servesVegetarianFood [read, assign] |
表示地点供应素食的地点属性。
- (GMSBooleanPlaceAttribute) wheelchairAccessibleEntrance [read, assign] |
表示地点在入口处有无障碍设施的地点属性。