Skip to content
Essentials for YOOtheme Pro

Google Places Source Provider

The Google Places Source feeds data from Google Places API supporting a Place.

Settings

Source Instance Common Settings

SettingDescriptionDefault
NameThe name that will identify this source instance.
Default Cache TimeThe default duration in seconds before the cache is renewed, set to 0 to disable caching. This setting can be overriden in each query configuration.3600
SettingDescription
AccountThe Google Account which to authenticate with.
API KeyThe Google Places API key for authenticating requests.

Place Query

Fetches a single place by Place ID and resolves to Place Type.

SettingDescriptionDefaultDynamic
Place IDThe unique Place ID to query.
CacheThe duration in seconds before the cache is invalidated and the query re-executed.3600

Place Type

Defines the mapping options of a Google Places Place object.

OptionDescriptionTypeFilters
Place IDThe unique identifier for this place.String
NameThe human-readable name of the place.StringLimit
Formatted AddressThe full address of the place.StringLimit
Address ComponentsThe address broken down into components.Address Component
Phone NumberThe place's phone number in international format.String
International Phone NumberThe place's phone number in international format with country code.String
WebsiteThe website associated with the place.String
URLThe URL of the Google Maps page for this place.String
RatingThe place's rating from 1.0 to 5.0, based on aggregated user reviews.Float
User Ratings TotalThe total number of ratings for this place.Int
Price LevelThe price level of the place, from 0 (free) to 4 (very expensive).Int
TypesThe types that describe the place, separated by comma.String
Business StatusThe operational status of the place: OPERATIONAL, CLOSED_TEMPORARILY, or CLOSED_PERMANENTLY.String
Opening HoursThe regular opening hours for the place.Opening Hours
PhotosPhotos associated with the place.Photo
ReviewsUser reviews for the place.Review
GeometryThe location and viewport of the place.Geometry
VicinityA simplified address for the place.StringLimit
UTC OffsetThe number of minutes this place's current timezone is offset from UTC.Int
IconThe URL of the icon for the place's category.String
Icon Background ColorThe hex color code of the place's category icon.String

Address Component Type

Defines the mapping options of an Address Component object.

FieldDescriptionType
Long NameThe full text description of the address component.String
Short NameThe abbreviated form of the address component.String
TypesThe types of this address component, separated by comma.String

Opening Hours Type

Defines the mapping options of an Opening Hours object.

FieldDescriptionType
Open NowWhether the place is currently open.Boolean
PeriodsThe periods describing when the place is open.Period
Weekday TextThe formatted opening hours for each day of the week, separated by line breaks.String

Period Type

Defines the mapping options of a Period object describing opening hours.

FieldDescriptionType
Open DayThe day of the week (0=Sunday, 6=Saturday) when the period starts.Int
Open TimeThe time of day in 24-hour "hhmm" format when the period starts.String
Close DayThe day of the week (0=Sunday, 6=Saturday) when the period ends.Int
Close TimeThe time of day in 24-hour "hhmm" format when the period ends.String

Photo Type

Defines the mapping options of a Photo object.

FieldDescriptionType
Photo ReferenceThe reference string used to construct the photo URL.String
WidthThe maximum width of the photo in pixels.Int
HeightThe maximum height of the photo in pixels.Int
HTML AttributionsThe attributions for the photo, separated by line breaks.String

Review Type

Defines the mapping options of a Review object.

FieldDescriptionTypeFilters
Author NameThe name of the user who submitted the review.StringLimit
Author URLThe URL to the user's Google Maps profile.String
LanguageThe language code for the review.String
Profile Photo URLThe URL to the user's profile photo.String
RatingThe user's rating for the place, from 1 to 5.Int
Relative Time DescriptionA relative time description of when the review was posted.StringLimit
TextThe review text.StringLimit
TimeThe time the review was submitted as a Unix timestamp.Int

Geometry Type

Defines the mapping options of a Geometry object.

FieldDescriptionType
LocationThe latitude and longitude of the place, separated by comma.String
LatitudeThe latitude of the place.Float
LongitudeThe longitude of the place.Float
ViewportThe viewport for displaying the place.Viewport

Viewport Type

Defines the mapping options of a Viewport object.

FieldDescriptionType
NortheastThe northeast corner of the viewport, formatted as "latitude,longitude".String
SouthwestThe southwest corner of the viewport, formatted as "latitude,longitude".String