Place

Класс места

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

Доступ осуществляется путем вызова const {Place} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

Place
Place(options)
Параметры:
searchByText
searchByText(request)
Параметры:
Возвращаемое значение: Promise <{places: Array < Place >}>
Поиск места на основе текстового запроса.
accessibilityOptions
Тип: AccessibilityOptions optional
Параметры доступности этого места. undefined , если данные опций доступности не были запрошены с сервера.
addressComponents
Тип: Array < AddressComponent > optional
Коллекция компонентов адреса для местоположения этого места. Пустой объект, если данные об известном адресе отсутствуют. undefined , если данные адреса не были запрошены с сервера.
adrFormatAddress
Тип: string optional
Представление адреса места в микроформате adr .
attributions
Тип: Array < Attribution > optional
Текст атрибуции, который будет отображаться для этого результата места.
businessStatus
Тип: BusinessStatus optional
Рабочее состояние локации. null , если статус неизвестен. undefined , если данные о состоянии не были загружены с сервера.
displayName
Тип: string optional
Отображаемое имя местоположения. null , если нет имени. undefined , если данные имени не были загружены с сервера.
editorialSummary
Тип: string optional
Редакционное резюме для этого места. null , если нет редакционного резюме. undefined если это поле еще не запрошено.
editorialSummaryLanguageCode
Тип: string optional
Язык редакционного резюме для этого места. null , если нет редакционного резюме. undefined если это поле еще не запрошено.
formattedAddress
Тип: string optional
Полный адрес локации.
googleMapsURI
Тип: string optional
URL официальной страницы Google этого места. Это страница, принадлежащая Google, которая содержит самую полную информацию об этом месте.
hasCurbsidePickup
Тип: boolean optional
Есть ли в этом месте самовывоз. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
hasDelivery
Тип: boolean optional
Есть ли в заведении доставка. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
hasDineIn
Тип: boolean optional
Указывает, где пообедали. Возвращает «истина» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
hasTakeout
Тип: boolean optional
Есть ли в заведении еда на вынос. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
iconBackgroundColor
Тип: string optional
Цветовой код HEX по умолчанию для категории места.
id
Тип: string
Уникальный идентификатор места.
internationalPhoneNumber
Тип: string optional
Номер телефона The Place в международном формате. Международный формат включает код страны и предваряется знаком плюс (+).
isReservable
Тип: boolean optional
Можно ли зарезервировать место. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
location
Тип: LatLng optional
Позиция места.
nationalPhoneNumber
Тип: string optional
Номер телефона The Place, отформатированный в соответствии с региональным соглашением о номере .
photos
Тип: Array < Photo > optional
Фотографии этого места. Коллекция будет содержать до десяти объектов Photo .
plusCode
Тип: PlusCode optional
priceLevel
Тип: PriceLevel optional
Уровень цен места. Это свойство может возвращать любое из следующих значений
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
Тип: number optional
Рейтинг от 1,0 до 5,0 на основе отзывов пользователей об этом месте.
regularOpeningHours
Тип: OpeningHours optional
requestedLanguage
Тип: string optional
Запрошенный язык для этого места.
requestedRegion
Тип: string optional
Запрошенный регион для этого места.
reviews
Тип: Array < Review > optional
Список отзывов об этом месте.
servesBeer
Тип: boolean optional
Подают ли место пиво. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
servesBreakfast
Тип: boolean optional
Подается ли в заведении завтрак. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
servesBrunch
Тип: boolean optional
Подается ли заведение поздний завтрак. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
servesDinner
Тип: boolean optional
Подается ли место ужином. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
servesLunch
Тип: boolean optional
Подается ли в заведении обед. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
servesVegetarianFood
Тип: boolean optional
Подается ли в заведении вегетарианская еда. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
servesWine
Тип: boolean optional
Подают ли место вино. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено.
svgIconMaskURI
Тип: string optional
URI ресурса маски изображения svg, который можно использовать для представления категории места.
types
Тип: Array <string> optional
Массив типов для этого места (например, ["political", "locality"] или ["restaurant", "establishment"] ).
userRatingCount
Тип: 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
Авторитетный веб-сайт этого места, например домашняя страница компании.
openingHours
Тип: OpeningHours optional
fetchFields
fetchFields(options)
Параметры:
Возвращаемое значение: Promise <{place: Place }>
Beta getNextOpeningTime
getNextOpeningTime([date])
Параметры:
  • date : Date optional
Возвращаемое значение: Promise < Date optional >
Вычисляет дату, представляющую следующее OpeningHoursTime. Возвращает неопределенное значение, если данных недостаточно для расчета результата или это место нерабочее.
Beta isOpen
isOpen([date])
Параметры:
  • date : Date optional . По умолчанию — сейчас.
Возвращаемое значение: Promise <boolean optional >
Проверьте, открыто ли место в указанную дату и время. Разрешается с помощью undefined , если известных данных о местоположении недостаточно для расчета, например, если часы работы не зарегистрированы.
toJSON
toJSON()
Параметры: Нет
Возвращаемое значение: Object JSON со всеми запрошенными свойствами Place.

Интерфейс PlaceOptions

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

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

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

Класс AccessibilityOptions

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

Доступ осуществляется путем вызова const {AccessibilityOptions} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

hasWheelchairAccessibleEntrance
Тип: boolean optional
Имеет ли место вход, оборудованный для гостей на инвалидных колясках. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно.
hasWheelchairAccessibleParking
Тип: boolean optional
Есть ли на месте парковка, оборудованная для инвалидов-колясочников. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно.
hasWheelchairAccessibleRestroom
Тип: boolean optional
Есть ли в заведении туалет, оборудованный для гостей на инвалидных колясках. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно.
hasWheelchairAccessibleSeating
Тип: boolean optional
Есть ли в заведении места, оборудованные для гостей на инвалидных колясках. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно.

Класс АдресКомпонента

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

Доступ осуществляется путем вызова const {AddressComponent} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

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

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

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

Доступ осуществляется путем вызова const {Attribution} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

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

Интерфейс FetchFieldsRequest

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

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

fields
Тип: Array <string>
Список полей, которые необходимо получить.

Класс открытия часов

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

Доступ осуществляется путем вызова const {OpeningHours} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

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

Класс OpeningHoursPeriod

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

Доступ осуществляется путем вызова const {OpeningHoursPeriod} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

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

Класс OpeningHoursPoint

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

Доступ осуществляется путем вызова const {OpeningHoursPoint} = await google.maps.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

Доступ осуществляется путем вызова const {Photo} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

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

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

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

Доступ осуществляется путем вызова const {AuthorAttribution} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

displayName
Тип: string
Имя автора этого результата.
photoURI
Тип: string optional
URI фотографии автора для этого результата. Это не всегда может быть доступно.
uri
Тип: string optional
URI профиля автора для этого результата.

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

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

Доступ осуществляется путем вызова const {PlusCode} = await google.maps.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 класса

Доступ осуществляется путем вызова const {Review} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

authorAttribution
Тип: AuthorAttribution optional
Рецензент.
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».

Константы ценового уровня

google.maps.places . PriceLevel Константы google.maps.places . PriceLevel

Перечисление уровня цен для объектов Place.

Доступ осуществляется путем вызова const {PriceLevel} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

Интерфейс SearchByTextRequest

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

Интерфейс запроса для Place.searchByText .

fields
Тип: Array <string>
Поля, которые необходимо включить в ответ, за который будет взиматься плата . Если передано ['*'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
includedType optional
Тип: string optional
Запрошенный тип места. Полный список поддерживаемых типов: https://developers.google.com/maps/documentation/places/web-service/place-types . Поддерживается только один включенный тип. См. SearchByTextRequest.useStrictTypeFiltering .
isOpenNow optional
Тип: boolean optional
По умолчанию: false
Используется для ограничения поиска местами, которые в данный момент открыты.
language optional
Тип: string optional
Информация о месте будет отображаться на предпочитаемом языке, если он доступен. По умолчанию будут выбраны языковые предпочтения браузера. Текущий список поддерживаемых языков: https://developers.google.com/maps/faq#languagesupport .
locationBias optional
Регион для поиска. Это местоположение служит предвзятостью, что означает, что могут быть возвращены результаты вокруг данного местоположения. Невозможно установить вместе с locationRestriction.
locationRestriction optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Регион для поиска. Это местоположение служит ограничением, которое означает, что результаты за пределами данного местоположения не будут возвращены. Невозможно установить вместе с locationBias.
maxResultCount optional
Тип: number optional
Максимальное количество возвращаемых результатов. Оно должно быть от 1 до 20 включительно.
minRating optional
Тип: number optional
Отфильтровывайте результаты, средний рейтинг пользователей которых строго меньше этого предела. Допустимое значение должно быть числом с плавающей запятой от 0 до 5 (включительно) с частотой 0,5, т. е. [0, 0,5, 1,0, ..., 5,0] включительно. Входной рейтинг будет округлен до ближайшего значения 0,5 (потолок). Например, рейтинг 0,6 исключит все результаты с рейтингом менее 1,0.
priceLevels optional
Тип: Array < PriceLevel > optional
Используется для ограничения поиска местами, отмеченными определенными уровнями цен. Могут быть выбраны любые комбинации уровней цен. По умолчанию для всех уровней цен.
query optional
Тип: string optional
Beta rankBy optional
Тип: SearchByTextRankPreference optional
rankPreference optional
Тип: SearchByTextRankPreference optional
По умолчанию: SearchByTextRankPreference.DISTANCE .
Как результаты будут ранжироваться в ответе.
region optional
Тип: string optional
Код страны/региона Unicode (CLDR) места, откуда поступает запрос. Этот параметр используется для отображения сведений о месте, например названия места для конкретного региона, если оно доступно. Параметр может повлиять на результаты в соответствии с действующим законодательством. Для получения дополнительной информации см. https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html . Обратите внимание, что трехзначные коды регионов в настоящее время не поддерживаются.
textQuery optional
Тип: string optional
Необходимый. Текстовый запрос для текстового поиска.
useStrictTypeFiltering optional
Тип: boolean optional
По умолчанию: false
Используется для установки строгой фильтрации типов для SearchByTextRequest.includedType . Если установлено значение true, будут возвращены только результаты одного типа.

Константы SearchByTextRankPreference

google.maps.places . SearchByTextRankPreference Константы google.maps.places . SearchByTextRankPreference

Перечисление RankPreference для SearchByTextRequest.

Доступ осуществляется путем вызова const {SearchByTextRankPreference} = await google.maps.importLibrary("places") . См. раздел Библиотеки в Maps JavaScript API .

DISTANCE Ранжирует результаты по расстоянию.
RELEVANCE Ранжирует результаты по релевантности.