Класс места
google.maps.places . Place
Класс google.maps.places . Place
Доступ осуществляется путем вызова const {Place} = await google.maps.importLibrary("places")
. См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
Place | Place(options) Параметры:
|
Статические методы | |
---|---|
findPlaceFromPhoneNumber | findPlaceFromPhoneNumber(request) Параметры:
Ищет место по заданному номеру телефона. Возвращает массив из-за редких случаев, когда несколько мест могут иметь один и тот же номер телефона. |
findPlaceFromQuery | findPlaceFromQuery(request) Параметры:
Ищет место по заданному текстовому запросу. Возвращает массив в случаях, когда запрос слегка неоднозначен и возвращается более одного места. Этот метод не предназначен для поиска, при котором ожидается несколько результатов. |
searchByText | searchByText(request) Параметры:
Поиск места на основе текстового запроса. |
Характеристики | |
---|---|
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 Есть ли в этом месте самовывоз. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено. |
hasDelivery | Тип: boolean optional Есть ли в заведении доставка. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено. |
hasDineIn | Тип: boolean optional Указывает, где пообедали. Возвращает «истина» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено. |
hasTakeout | Тип: boolean optional Есть ли в заведении еда на вынос. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено. |
hasWheelchairAccessibleEntrance | Тип: boolean optional Имеет ли место вход, оборудованный для гостей на инвалидных колясках. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено. |
iconBackgroundColor | Тип: string optional Цветовой код HEX по умолчанию для категории места. |
id | Тип: string Уникальный идентификатор места. |
internationalPhoneNumber | Тип: string optional Номер телефона The Place в международном формате. Международный формат включает код страны и предваряется знаком плюс (+). |
isReservable | Тип: boolean optional Можно ли зарезервировать место. Возвращает «истину» или «ложь», если значение известно. Возвращает «ноль», если значение неизвестно. Возвращает «неопределенное», если это поле еще не запрошено. |
location | Тип: LatLng optional Позиция места. |
nationalPhoneNumber | Тип: string optional Номер телефона The Place, отформатированный в соответствии с региональным соглашением о номере . |
openingHours | Тип: OpeningHours optional |
photos | Фотографии этого места. Коллекция будет содержать до десяти Photo . |
plusCode | Тип: PlusCode optional |
priceLevel | Тип: PriceLevel optional Уровень цен места. Это свойство может возвращать любое из следующих значений
|
rating | Тип: number optional Рейтинг от 1,0 до 5,0 на основе отзывов пользователей об этом месте. |
requestedLanguage | Тип: string optional Запрошенный язык для этого места. |
requestedRegion | Тип: string optional Запрошенный регион для этого места. |
reviews | Список отзывов об этом месте. |
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 Авторитетный веб-сайт этого места, например домашняя страница компании. |
Методы | |
---|---|
fetchFields | fetchFields(options) Параметры:
|
getNextOpeningTime | getNextOpeningTime([date]) Параметры:
Вычисляет дату, представляющую следующее OpeningHoursTime. Возвращает неопределенное значение, если данных недостаточно для расчета результата или это место нерабочее. |
isOpen | isOpen([date]) Параметры:
Возвращаемое значение: 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» (технически для организации «Соединенное Королевство Великобритании и Северной Ирландии»). |
Класс АдресКомпонента
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> Список полей, которые необходимо получить. |
sessionToken optional | Тип: AutocompleteSessionToken optional Уникальная ссылка, используемая для объединения запроса подробностей с сеансом автозаполнения. |
Класс открытия часов
google.maps.places . OpeningHours
Класс google.maps.places . OpeningHours
Доступ осуществляется путем вызова const {OpeningHours} = await google.maps.importLibrary("places")
. См. раздел Библиотеки в Maps JavaScript API .
Характеристики | |
---|---|
periods | Тип: Array < OpeningHoursPeriod > Периоды работы охватывают каждый день недели, начиная с воскресенья, в хронологическом порядке. Не включает дни, когда Заведение не работает. |
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 Время открытия места. |
Класс 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 | Тип: Array < AuthorAttribution > Текст авторства, который будет отображаться для этой фотографии. |
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> Поля, которые будут включены в ответ, за который будет взиматься плата . Если передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. 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 | Тип: LatLng | LatLngLiteral | LatLngBounds | LatLngBoundsLiteral | CircleLiteral | Circle 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 Используется для ограничения поиска местами, отмеченными определенными уровнями цен. Могут быть выбраны любые комбинации уровней цен. По умолчанию для всех уровней цен. |
| Тип: string optional |
rankBy optional | Тип: SearchByTextRankBy optional По умолчанию: SearchByTextRankBy.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, будут возвращены только результаты одного типа. |
Константы SearchByTextRankBy
google.maps.places . SearchByTextRankBy
Константы google.maps.places . SearchByTextRankBy
Перечисление RankBy для SearchByTextRequest.
Доступ осуществляется путем вызова const {SearchByTextRankBy} = await google.maps.importLibrary("places")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
DISTANCE | Ранжирует результаты по расстоянию. |
RELEVANCE | Ранжирует результаты по релевантности. |