Place (beta)

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Место класса

google.maps.places . Place класса

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {Place} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

Place
Place(options)
Параметры:
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
Параметры:
Возвращаемое значение: Promise <{places: Array < Place >}>
Поиск места по заданному номеру телефона. Возвращает массив из-за редких случаев, когда несколько мест могут иметь общий номер телефона.
findPlaceFromQuery
findPlaceFromQuery(request)
Параметры:
  • request : FindPlaceFromQueryRequest Запрос, содержащий текстовый запрос и запрошенные поля.
Возвращаемое значение: Promise <{places: Array < Place >}>
Ищет место на основе заданного текстового запроса. Возвращает массив из-за случаев, когда запрос слегка неоднозначен и возвращается более одного места. Этот метод не предназначен для поиска, когда ожидается несколько результатов.
addressComponents
Тип: Array < AddressComponent > optional
Набор компонентов адреса для местоположения этого места. Пустой объект, если нет известных адресных данных. undefined , если адресные данные не запрашивались с сервера.
adrFormatAddress
Тип: string optional
Представление адреса места в микроформате adr .
attributions
Тип: Array < Attribution > optional
Текст атрибуции, который будет отображаться для этого результата места.
businessStatus
Тип: BusinessStatus optional
Рабочий статус локации. null , если нет известного статуса. undefined , если данные о состоянии не были загружены с сервера.
displayName
Тип: string optional
Отображаемое имя местоположения. null , если нет имени. undefined , если данные имени не были загружены с сервера.
formattedAddress
Тип: string optional
Полный адрес локации.
googleMapsURI
Тип: string optional
URL официальной страницы Google для этого места. Это страница, принадлежащая Google, которая содержит самую полную доступную информацию о месте.
hasCurbsidePickup
Тип: boolean optional
Есть ли у места самовывоз. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
hasDelivery
Тип: boolean optional
Есть ли доставка. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
hasDineIn
Тип: boolean optional
Есть ли место, где обедали. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
hasTakeout
Тип: boolean optional
Есть ли в заведении еда на вынос. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
hasWheelchairAccessibleEntrance
Тип: boolean optional
Есть ли у места вход, доступный для инвалидных колясок. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
icon
Тип: string optional
URL-адрес ресурса изображения, который можно использовать для представления категории этого местоположения.
iconBackgroundColor
Тип: string optional
Цветовой код HEX по умолчанию для категории места.
id
Тип: string
Уникальный идентификатор места.
internationalPhoneNumber
Тип: string optional
Номер телефона Place в международном формате. Международный формат включает код страны и предшествует знаку плюс (+).
isReservable
Тип: boolean optional
Можно ли забронировать место. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
location
Тип: LatLng optional
Позиция Place.
nationalPhoneNumber
Тип: string optional
Номер телефона Place, отформатированный в соответствии с региональными правилами .
openingHours
Тип: OpeningHours optional
photos
Тип: Array < Photo > optional
Фотографии этого места. Коллекция будет содержать до десяти Photo .
plusCode
Тип: PlusCode optional
priceLevel
Тип: number optional
Уровень цен Места по шкале от 0 до 4. Уровни цен интерпретируются следующим образом:
  • 0 : Бесплатно
  • 1 : Недорогой
  • 2 : Умеренный
  • 3 : Дорого
  • 4 : Очень дорого
rating
Тип: number optional
Рейтинг от 1,0 до 5,0, основанный на отзывах пользователей об этом месте.
requestedLanguage
Тип: string optional
Запрашиваемый язык для этого места.
requestedRegion
Тип: string optional
Запрашиваемый регион для этого места.
reviews
Тип: Array < Review > optional
Список отзывов об этом месте.
servesBeer
Тип: boolean optional
Где подают пиво. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
servesBreakfast
Тип: boolean optional
Где подают завтрак. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
servesBrunch
Тип: boolean optional
Подают ли место поздний завтрак. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
servesDinner
Тип: boolean optional
Где подают ужин. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
servesLunch
Тип: boolean optional
Подают ли место обед. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
servesVegetarianFood
Тип: boolean optional
Подается ли в заведении вегетарианская еда. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
servesWine
Тип: boolean optional
Подают ли место вино. Возвращает «истина» или «ложь», если значение известно. Возвращает 'null', если значение неизвестно. Возвращает undefined, если это поле еще не было запрошено.
svgIconMaskURI
Тип: string optional
URI ресурса маски изображения svg, который можно использовать для представления категории места.
types
Тип: Array <string> optional
Массив типов для этого места (например, ["political", "locality"] или ["restaurant", "establishment"] ).
userRatingsCount
Тип: number optional
Количество оценок пользователей, внесших свой вклад в Place.rating этого места.
utcOffsetMinutes
Тип: number optional
Смещение от UTC текущего часового пояса места в минутах. Например, австрийское восточное стандартное время (GMT+10) с учетом летнего времени на 11 часов опережает UTC, поэтому utc_offset_minutes будет равен 660 . Для часовых поясов ниже UTC смещение отрицательное. Например, utc_offset_minutes равен -60 для Кабо-Верде.
viewport
Тип: LatLngBounds optional
Предпочтительный экран просмотра при отображении этого места на карте.
websiteURI
Тип: string optional
Официальный веб-сайт этого места, например домашняя страница компании.
fetchFields
fetchFields(options)
Параметры:
Возвращаемое значение: Promise <{place: Place }>
getNextOpeningTime
getNextOpeningTime([date])
Параметры:
  • date : Date optional
Возвращаемое значение: Promise < Date optional >
Вычисляет отметку времени (в миллисекундах с начала эпохи, подходит для использования с new Date() ), представляющую следующий OpeningHoursTime. Возвращает undefined, если данных недостаточно для расчета результата или это место не работает.
isOpen
isOpen([date])
Параметры:
  • date : Date optional . По умолчанию используется сейчас.
Возвращаемое значение: Promise <boolean optional >
Проверьте, открыто ли место в указанную дату и время. Разрешается с помощью undefined , если известных данных о местоположении недостаточно для расчета, например, если часы работы не зарегистрированы.

Интерфейс PlaceOptions

google.maps.places . PlaceOptions Интерфейс google.maps.places . PlaceOptions

Варианты построения Места.

id
Тип: string
Уникальный идентификатор места.
requestedLanguage optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены сведения. См. список поддерживаемых языков .
requestedRegion optional
Тип: string optional
Региональный код региона пользователя. Это может повлиять на то, какие фотографии могут быть возвращены, и, возможно, на другие вещи. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Соединенного Королевства — «uk» ( .co.uk ), а его код ISO 3166-1 — «gb» (технически для субъекта «Соединенное Королевство Великобритании и Северной Ирландии»).

Класс AddressComponent

google.maps.places . AddressComponent Класс google.maps.places . AddressComponent

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {AddressComponent} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

longText
Тип: string optional
Полный текст компонента адреса.
shortText
Тип: string optional
Сокращенный, краткий текст данного компонента адреса.
types
Тип: Array <string>
Массив строк, обозначающих тип этого компонента адреса. Список допустимых типов можно найти здесь .

Класс атрибуции

google.maps.places . Attribution Класс google.maps.places . Attribution

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {Attribution} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

provider
Тип: string optional
Текст атрибуции, который будет отображаться для этого результата места.
providerURI
Тип: string optional

Интерфейс FetchFieldsRequest

google.maps.places . FetchFieldsRequest Интерфейс google.maps.places . FetchFieldsRequest

Варианты получения полей места.

fields
Тип: Array <string>
Список полей для выборки.
sessionToken optional
Тип: AutocompleteSessionToken optional
Уникальная ссылка, используемая для связывания запроса сведений с сеансом автозаполнения.

Класс OpeningHours

google.maps.places . OpeningHours Класс google.maps.places . OpeningHours

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta можно получить доступ, вызвав const {OpeningHours} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

periods
Периоды работы, охватывающие каждый день недели, начиная с воскресенья, в хронологическом порядке. Не включает дни, когда место не работает.
weekdayDescriptions
Тип: Array <string>
Массив из семи строк, представляющих отформатированные часы работы для каждого дня недели. Служба Places отформатирует и локализует часы работы в соответствии с текущим языком. Порядок элементов в этом массиве зависит от языка. Некоторые языки начинают неделю в понедельник, а другие — в воскресенье.

Класс OpeningHoursPeriod

google.maps.places . OpeningHoursPeriod Класс google.maps.places . OpeningHoursPeriod

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {OpeningHoursPeriod} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

close
Тип: OpeningHoursPoint optional
Время закрытия Места.
open
Время открытия места.

Класс OpeningHoursPoint

google.maps.places . OpeningHoursPoint Класс google.maps.places . OpeningHoursPoint

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {OpeningHoursPoint} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

day
Тип: number
День недели в виде числа в диапазоне [0, 6], начиная с воскресенья. Например, 2 означает вторник.
hour
Тип: number
Час OpeningHoursPoint.time в виде числа в диапазоне [0, 23]. Об этом будет сообщено в часовом поясе места.
minute
Тип: number
Минуты OpeningHoursPoint.time в виде числа в диапазоне [0, 59]. Об этом будет сообщено в часовом поясе места.

Фото класс

google.maps.places . Photo класс

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {Photo} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

attributions
Тип: Array < PhotoAttribution >
Текст авторства, который будет отображаться для этой фотографии.
heightPx
Тип: number
Высота фотографии в пикселях.
widthPx
Тип: number
Ширина фотографии в пикселях.
getURI
getURI([options])
Параметры:
Возвращаемое значение: string
Возвращает URL-адрес изображения, соответствующий указанным параметрам.

Класс PhotoAttribution

google.maps.places . PhotoAttribution Класс google.maps.places . PhotoAttribution

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {PhotoAttribution} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

author
Тип: string
Текст авторства, который будет отображаться для этого результата Фото.
authorURI
Тип: string optional

ПлюсКод класс

google.maps.places . PlusCode класс

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {PlusCode} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

compoundCode
Тип: string optional
Плюс-код с 1/8000 градуса на 1/8000 градуса области, где первые четыре символа (код города) опущены и заменены описанием местности. Например, «9G8F+5W Цюрих, Швейцария».
globalCode
Тип: string optional
Плюс-код с размером 1/8000 градуса на 1/8000 градуса площади. Например, «8FVC9G8F+5W».

Обзор класса

google.maps.places . Review класса

Загрузите с помощью параметра URL &libraries=places . См. Библиотеки в Maps JavaScript API .

При использовании v=beta к нему можно получить доступ, вызвав const {Review} = await google.map.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

author
Тип: string optional
Имя рецензента.
authorPhotoURI
Тип: string optional
URL-адрес изображения профиля рецензента.
authorURI
Тип: string optional
URL-адрес профиля рецензента.
publishTime
Тип: Date optional
rating
Тип: number optional
Рейтинг данного обзора, число от 1,0 до 5,0 (включительно).
relativePublishTimeDescription
Тип: string optional
Строка отформатированного недавнего времени, выражающая время проверки относительно текущего времени в форме, подходящей для языка и страны. Например, "месяц назад".
text
Тип: string optional
Текст отзыва.
textLanguageCode
Тип: string optional
Код языка IETF, указывающий язык, на котором написан этот обзор. Обратите внимание, что этот код включает только тег основного языка без каких-либо дополнительных тегов, указывающих страну или регион. Например, все обзоры на английском языке помечены как 'en' а не «en-AU» или «en-UK».