Places Service

Класс PlacesService

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

Содержит методы, связанные с поиском мест и получением сведений о месте.

Получите доступ, вызвав const {PlacesService} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

PlacesService
PlacesService(attrContainer)
Параметры:
Создает новый экземпляр PlacesService , который отображает атрибуты в указанном контейнере.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест по номеру телефона. В большинстве случаев в списке результатов должен быть только один элемент, однако, если запрос неоднозначен, может быть возвращено более одного результата. PlaceResult , переданные обратному вызову, являются подмножествами полного PlaceResult . Ваше приложение может получить более подробный PlaceResult для каждого места, вызвав PlacesService.getDetails и передав PlaceResult.place_id для нужного места.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест на основе строки запроса. В большинстве случаев в списке результатов должен быть только один элемент, однако, если запрос неоднозначен, может быть возвращено более одного результата. PlaceResult , переданные обратному вызову, являются подмножествами полного PlaceResult . Ваше приложение может получить более подробный PlaceResult для каждого места, вызвав PlacesService.getDetails и передав PlaceResult.place_id для нужного места.
getDetails
getDetails(request, callback)
Параметры:
Возвращаемое значение: нет
Извлекает сведения о месте, указанном по заданному placeId .
nearbySearch
nearbySearch(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест рядом с определенным местом на основе ключевого слова или типа. Расположение всегда должно быть указано либо путем передачи LatLngBounds , либо параметров location и radius . PlaceResult , передаваемые обратному вызову, являются подмножествами полного PlaceResult . Ваше приложение может получить более подробный PlaceResult для каждого места, отправив запрос Place Details , передав PlaceResult.place_id для нужного места. Объект PlaceSearchPagination можно использовать для получения дополнительных страниц результатов (null, если это последняя страница результатов или если есть только одна страница результатов).
textSearch
textSearch(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест на основе строки запроса (например, "пицца в Нью-Йорке" или "обувные магазины недалеко от Оттавы"). Параметры местоположения необязательны; когда местоположение указано, результаты смещаются только в сторону ближайших результатов, а не ограничиваются местами внутри области. Используйте textSearch , когда вы хотите искать места, используя произвольную строку, и в случаях, когда вы не хотите ограничивать результаты поиска определенным местоположением. Объект PlaceSearchPagination можно использовать для получения дополнительных страниц результатов (null, если это последняя страница результатов или если есть только одна страница результатов).

Интерфейс PlaceDetailsRequest

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

Запрос сведений о месте для отправки в PlacesService .

placeId
Тип: string
Идентификатор места, сведения о котором запрашиваются.
fields optional
Тип: Array <string> optional
Поля, которые должны быть включены в подробный ответ, за который будет выставлен счет . Если поля не указаны или передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены сведения. См. список поддерживаемых языков .
region optional
Тип: string optional
Региональный код региона пользователя. Это может повлиять на то, какие фотографии могут быть возвращены, и, возможно, на другие вещи. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Соединенного Королевства — «uk» ( .co.uk ), а его код ISO 3166-1 — «gb» (технически для субъекта «Соединенное Королевство Великобритании и Северной Ирландии»).
sessionToken optional
Тип: AutocompleteSessionToken optional
Уникальная ссылка, используемая для связывания запроса сведений с сеансом автозаполнения.

Интерфейс FindPlaceFromPhoneNumberRequest

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

Поиск места из запроса текстового поиска для отправки в PlacesService.findPlaceFromPhoneNumber .

fields
Тип: Array <string>
Поля, которые должны быть включены в ответ, за который будет взиматься плата . Если передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
phoneNumber
Тип: string
Номер телефона места для поиска. Формат должен быть E.164 .
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
locationBias optional
Тип: LocationBias optional
Смещение, используемое при поиске места. Результат будет смещен в сторону заданного LocationBias , но не ограничиваться им.

Интерфейс FindPlaceFromQueryRequest

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

Место поиска из запроса текстового поиска для отправки в PlacesService.findPlaceFromQuery .

fields
Тип: Array <string>
Поля, которые должны быть включены в ответ, за который будет взиматься плата . Если передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
query
Тип: string
Запрос запроса. Например, название или адрес места.
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
locationBias optional
Тип: LocationBias optional
Смещение, используемое при поиске места. Результат будет смещен в сторону заданного LocationBias , но не ограничиваться им.

Интерфейс PlaceSearchRequest

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

Запрос поиска места для отправки в PlacesService .

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Границы, в которых следует искать Places. И location , и radius будут игнорироваться, если установлены bounds .
keyword optional
Тип: string optional
Термин, который должен сопоставляться со всеми доступными полями, включая, помимо прочего, имя, тип и адрес, а также отзывы клиентов и другой сторонний контент.
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
location optional
Тип: LatLng | LatLngLiteral optional
Местоположение, вокруг которого следует искать Places.
maxPriceLevel optional
Тип: number optional
Ограничивает результаты только теми местами с указанным ценовым уровнем или ниже. Допустимые значения находятся в диапазоне от 0 (самый доступный) до 4 (самый дорогой) включительно. Должно быть больше или равно minPrice , если указано.
minPriceLevel optional
Тип: number optional
Ограничивает результаты только местами с указанным ценовым уровнем или выше. Допустимые значения находятся в диапазоне от 0 (самый доступный) до 4 (самый дорогой) включительно. Должно быть меньше или равно maxPrice , если указано.
name optional name optional
Тип: string optional
Эквивалент keyword . Значения в этом поле объединяются со значениями в поле keyword и передаются как часть той же строки поиска.
openNow optional
Тип: boolean optional
Ограничивает результаты только теми местами, которые открыты прямо сейчас.
radius optional
Тип: number optional
Расстояние от заданного местоположения, в пределах которого нужно искать места, в метрах. Максимально допустимое значение 50 000.
rankBy optional
Тип: RankBy optional
По умолчанию: RankBy.PROMINENCE
Указывает метод ранжирования, используемый при возврате результатов. Обратите внимание, что когда для rankBy установлено значение DISTANCE , вы должны указать location , но не можете указать radius или bounds .
type optional
Тип: string optional
Ищет места заданного типа. Тип переводится на местный язык целевого местоположения запроса и используется в качестве строки запроса. Если также предоставляется запрос, он объединяется со строкой локализованного типа. Результаты другого типа удаляются из ответа. Используйте это поле для выполнения поиска по категориям, не зависящим от языка и региона. Допустимые типы приведены здесь .

Интерфейс TextSearchRequest

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

Запрос текстового поиска для отправки в PlacesService .

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Границы, используемые для смещения результатов при поиске мест (необязательно). И location , и radius будут игнорироваться, если установлены bounds . Результаты не будут ограничены теми, кто находится внутри этих границ; но результаты внутри него будут иметь более высокий рейтинг.
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
location optional
Тип: LatLng | LatLngLiteral optional
Центр области, используемый для смещения результатов при поиске мест.
query optional
Тип: string optional
Термин запроса запроса. Например, название места ("Эйфелева башня"), категория, за которой следует название места ("пицца в Нью-Йорке"), или название места, за которым следует символ устранения неоднозначности местоположения ("Старбакс в Сиднее" ).
radius optional
Тип: number optional
Радиус области, используемой для смещения результатов при поиске мест, в метрах.
region optional
Тип: string optional
Код региона для смещения результатов. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Соединенного Королевства — «uk» ( .co.uk ), а его код ISO 3166-1 — «gb» (технически для субъекта «Соединенное Королевство Великобритании и Северной Ирландии»).
type optional
Тип: string optional
Ищет места заданного типа. Тип переводится на местный язык целевого местоположения запроса и используется в качестве строки запроса. Если также предоставляется запрос, он объединяется со строкой локализованного типа. Результаты другого типа удаляются из ответа. Используйте это поле для выполнения поиска по категориям, не зависящим от языка и региона. Допустимые типы приведены здесь .

Константы RankBy

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

Варианты ранжирования для PlaceSearchRequest.

Получите доступ, вызвав const {RankBy} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

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

LocationBias typedef

google.maps.places . LocationBias typedef

LocationBias представляет собой мягкую границу или подсказку для использования при поиске мест. Результаты могут поступать из-за пределов указанной области. Чтобы использовать IP-адрес текущего пользователя в качестве смещения, можно указать строку "IP_BIAS" . Примечание: при использовании Circle необходимо определить центр и радиус.

LatLng | LatLngLiteral | LatLngBounds | LatLngBoundsLiteral | Circle | CircleLiteral |string

LocationRestriction typedef

google.maps.places . LocationRestriction typedef

LocationRestriction представляет собой строгую границу для использования при поиске Places.

LatLngBounds | LatLngBoundsLiteral

Константы PlacesServiceStatus

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

Статус, возвращаемый PlacesService по завершении поиска. Укажите их по значению или по имени константы. Например, 'OK' или google.maps.places.PlacesServiceStatus.OK .

Получите доступ, вызвав const {PlacesServiceStatus} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

INVALID_REQUEST Этот запрос недействителен.
NOT_FOUND Указанное место не найдено.
OK Ответ содержит действительный результат.
OVER_QUERY_LIMIT Приложение превысило свою квоту запросов.
REQUEST_DENIED Приложению не разрешено использовать PlacesService .
UNKNOWN_ERROR Запрос PlacesService не может быть обработан из-за ошибки сервера. Запрос может быть успешным, если вы попробуете еще раз.
ZERO_RESULTS По этому запросу ничего не найдено.

Интерфейс PlaceSearchPagination

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

Объект, используемый для получения дополнительных страниц результатов Places.

hasNextPage
Тип: boolean
Указывает, доступны ли дальнейшие результаты. true , когда есть дополнительная страница результатов.
nextPage
nextPage()
Параметры: Нет
Возвращаемое значение: нет
Выбирает следующую страницу результатов. Использует ту же функцию обратного вызова, которая была предоставлена ​​для первого поискового запроса.

Интерфейс PlaceResult

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

Определяет информацию о месте.

address_components optional
Тип: Array < GeocoderAddressComponent > optional
Набор компонентов адреса для местоположения этого места. Доступно только с PlacesService.getDetails .
adr_address optional
Тип: string optional
Представление адреса места в микроформате adr . Доступно только с PlacesService.getDetails .
aspects optional
Тип: Array < PlaceAspectRating > optional
Оценка аспектов этого места на основе отзывов пользователей Google и Zagat. Оценки выставляются по шкале от 0 до 30.
business_status optional
Тип: BusinessStatus optional
Флаг, указывающий на рабочий статус места, если это бизнес (указывает, работает ли место или закрыто временно или постоянно). Если данные недоступны, флаг отсутствует в ответах поиска или подробностей.
formatted_address optional
Тип: string optional
Полный адрес места.
formatted_phone_number optional
Тип: string optional
Номер телефона Place, отформатированный в соответствии с региональными правилами . Доступно только с PlacesService.getDetails .
geometry optional
Тип: PlaceGeometry optional
Информация о геометрии места.
html_attributions optional
Тип: Array <string> optional
Текст атрибуции, который будет отображаться для этого результата места. Доступные html_attributions всегда возвращаются независимо от того, какие fields были запрошены, и должны отображаться.
icon optional
Тип: string optional
URL-адрес ресурса изображения, который можно использовать для представления категории этого места.
icon_background_color optional
Тип: string optional
Цвет фона для использования со значком места. См. также PlaceResult.icon_mask_base_uri .
icon_mask_base_uri optional
Тип: string optional
Усеченный URL-адрес маски значка. Получите доступ к различным типам значков, добавив расширение файла в конец (например .svg или .png ).
international_phone_number optional
Тип: string optional
Номер телефона Place в международном формате. Международный формат включает код страны и предшествует знаку плюс (+). Доступно только с PlacesService.getDetails .
name optional
Тип: string optional
Название места. Примечание. В случае, если Места введены пользователем, это необработанный текст, введенный пользователем. Пожалуйста, соблюдайте осторожность при использовании этих данных, так как злоумышленники могут попытаться использовать их в качестве вектора для атак путем внедрения кода (см. http://en.wikipedia.org/wiki/Code_injection ).
opening_hours optional
Тип: PlaceOpeningHours optional
Определяет, когда место открывается или закрывается.
permanently_closed optional permanently_closed optional
Тип: boolean optional
Флаг, указывающий, закрыто ли место навсегда или временно. Если место работает или нет данных, флаг в ответе отсутствует.
photos optional
Тип: Array < PlacePhoto > optional
Фотографии этого места. Коллекция будет содержать до десяти объектов PlacePhoto .
place_id optional
Тип: string optional
Уникальный идентификатор места.
plus_code optional
Тип: PlacePlusCode optional
Определяет открытые коды местоположения или « плюс-коды » для места.
price_level optional
Тип: number optional
Уровень цен Места по шкале от 0 до 4. Уровни цен интерпретируются следующим образом:
  • 0 : Бесплатно
  • 1 : Недорогой
  • 2 : Умеренный
  • 3 : Дорого
  • 4 : Очень дорого
rating optional
Тип: number optional
Рейтинг от 1,0 до 5,0, основанный на отзывах пользователей об этом месте.
reviews optional
Тип: Array < PlaceReview > optional
Список отзывов об этом месте. Доступно только с PlacesService.getDetails .
types optional
Тип: Array <string> optional
Массив типов для этого места (например, ["political", "locality"] или ["restaurant", "establishment"] ).
url optional
Тип: string optional
URL официальной страницы Google для этого места. Это страница, принадлежащая Google, которая содержит самую полную доступную информацию о месте. Доступно только с PlacesService.getDetails .
user_ratings_total optional
Тип: number optional
Количество пользовательских оценок, повлиявших на PlaceResult.rating этого места.
utc_offset optional utc_offset optional
Тип: number optional
Смещение от UTC текущего часового пояса места в минутах. Например, Сидней, Австралия, при переходе на летнее время на 11 часов опережает UTC, поэтому utc_offset будет равен 660 . Для часовых поясов ниже UTC смещение отрицательное. Например, utc_offset равен -60 для Кабо-Верде. Доступно только с PlacesService.getDetails .
utc_offset_minutes optional
Тип: number optional
Смещение от UTC текущего часового пояса места в минутах. Например, Сидней, Австралия, при переходе на летнее время на 11 часов опережает UTC, поэтому utc_offset_minutes будет равен 660 . Для часовых поясов ниже UTC смещение отрицательное. Например, utc_offset_minutes равен -60 для Кабо-Верде. Доступно только с PlacesService.getDetails .
vicinity optional
Тип: string optional
Упрощенный адрес места, включая название улицы, номер улицы и населенный пункт, но не провинцию/штат, почтовый индекс или страну. Например, офис Google в Сиднее, Австралия, имеет значение окрестности "48 Pirrama Road, Pyrmont" . Доступно только с PlacesService.getDetails .
website optional
Тип: string optional
Официальный веб-сайт этого места, например домашняя страница компании. Доступно только с PlacesService.getDetails .

Интерфейс PlaceAspectRating

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

Определяет информацию об аспекте места, которое пользователи просмотрели.

rating
Тип: number
Рейтинг этого аспекта. Для отдельных отзывов это целое число от 0 до 3. Для агрегированных оценок места это целое число от 0 до 30.
type
Тип: string
Тип аспекта. Например, "food" , "decor" , "service" или "overall" .

Константы BusinessStatus

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

Рабочий статус места, если это бизнес, возвращается в PlaceResult (указывает, работает ли место или закрыто временно или постоянно). Укажите их по значению или имени константы (пример: 'OPERATIONAL' или google.maps.places.BusinessStatus.OPERATIONAL ).

Получите доступ, вызвав const {BusinessStatus} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

CLOSED_PERMANENTLY Бизнес закрыт навсегда.
CLOSED_TEMPORARILY Бизнес временно закрыт.
OPERATIONAL Бизнес работает в обычном режиме.

Интерфейс PlaceGeometry

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

Определяет информацию о геометрии места.

location optional
Тип: LatLng optional
Позиция Place.
viewport optional
Тип: LatLngBounds optional
Предпочтительный экран просмотра при отображении этого места на карте. Это свойство будет иметь null , если предпочтительная область просмотра для места неизвестна. Доступно только с PlacesService.getDetails .

Интерфейс PlaceOpeningHours

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

Определяет информацию о часах работы места.

open_now optional open_now optional
Тип: boolean optional
Открыто ли место в настоящее время.
periods optional
Тип: Array < PlaceOpeningHoursPeriod > optional
Периоды работы, охватывающие каждый день недели, начиная с воскресенья, в хронологическом порядке. Дни, в которые Место не открыто, не учитываются. Доступно только с PlacesService.getDetails .
weekday_text optional
Тип: Array <string> optional
Массив из семи строк, представляющих отформатированные часы работы для каждого дня недели. Служба Places отформатирует и локализует часы работы в соответствии с текущим языком. Порядок элементов в этом массиве зависит от языка. Некоторые языки начинают неделю в понедельник, а другие — в воскресенье. Доступно только с PlacesService.getDetails . Другие вызовы могут возвращать пустой массив.
isOpen
isOpen([date])
Параметры:
  • date : Date optional
Возвращаемое значение: boolean|undefined
Проверьте, открыто ли место сейчас (когда дата не прошла) или в указанную дату. Если у этого места нет PlaceResult.utc_offset_minutes или PlaceOpeningHours.periods , то возвращается undefined ( PlaceOpeningHours.periods доступен только через PlacesService.getDetails ). Этот метод не принимает во внимание исключительные часы, такие как праздничные часы.

Интерфейс PlaceOpeningHoursPeriod

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

Определяет структурированную информацию о часах работы места. Примечание. Если место всегда открыто , раздел close в ответе будет отсутствовать. Клиенты могут полагаться на то, что всегда открыто, представленное как open период, содержащий day со значением 0 и time со значением "0000" и без close .

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

Интерфейс PlaceOpeningHoursTime

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

Определяет, когда место открывается или закрывается.

day
Тип: number
Дни недели в виде числа в диапазоне [ 0 , 6 ], начиная с воскресенья. Например, 2 означает вторник.
hours
Тип: number
Часы PlaceOpeningHoursTime.time в виде числа в диапазоне [ 0 , 23 ]. Об этом будет сообщено в часовом поясе места.
minutes
Тип: number
Минуты PlaceOpeningHoursTime.time в виде числа в диапазоне [ 0 , 59 ]. Об этом будет сообщено в часовом поясе места.
time
Тип: string
Время суток в 24-часовом формате «ччмм». Значения находятся в диапазоне [ "0000" , "2359" ]. Время будет указано в часовом поясе места.
nextDate optional
Тип: number optional
Отметка времени (в миллисекундах с начала эпохи, подходящая для использования с new Date() ), представляющая следующее вхождение этого PlaceOpeningHoursTime. Он рассчитывается из PlaceOpeningHoursTime.day недели, PlaceOpeningHoursTime.time и PlaceResult.utc_offset_minutes . Если PlaceResult.utc_offset_minutes undefined , то и nextDate будет undefined .

Интерфейс PlacePlusCode

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

Определяет открытые коды местоположения или « плюс-коды » для места. Плюс-коды можно использовать в качестве замены уличных адресов в местах, где их нет (где здания не пронумерованы или улицы не названы).

global_code
Тип: string
Плюс-код с размером 1/8000 градуса на 1/8000 градуса площади. Например, "8FVC9G8F+5W" .
compound_code optional
Тип: string optional
Плюс-код с 1/8000 градуса на 1/8000 градуса области, где первые четыре символа (код города) опущены и заменены описанием местности. Например, "9G8F+5W Zurich, Switzerland" . Если нет подходящей местности, где можно было бы сократить код, то это поле опускается.

Интерфейс PlacePhoto

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

Представляет фотоэлемент Place.

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

Интерфейс PhotoOptions

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

Определяет параметры запроса фотографий.

maxHeight optional
Тип: number optional
Максимальная высота возвращаемого изображения в пикселях.
maxWidth optional
Тип: number optional
Максимальная ширина возвращаемого изображения в пикселях.

Интерфейс PlaceReview

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

Представляет один отзыв о месте.

author_name
Тип: string
Имя рецензента.
language
Тип: string
Код языка IETF, указывающий язык, на котором написан этот обзор. Обратите внимание, что этот код включает только тег основного языка без каких-либо дополнительных тегов, указывающих страну или регион. Например, все обзоры на английском языке помечены как 'en' , а не «en-AU» или «en-UK».
profile_photo_url
Тип: string
URL-адрес изображения профиля рецензента.
relative_time_description
Тип: string
Строка отформатированного недавнего времени, выражающая время проверки относительно текущего времени в форме, подходящей для языка и страны. Например "a month ago" .
text
Тип: string
Текст отзыва.
time
Тип: number
Временная метка обзора, выраженная в секундах с начала эпохи.
aspects optional aspects optional
Тип: Array < PlaceAspectRating > optional
Аспекты, оцененные обзором. Оценки по шкале от 0 до 3.
author_url optional
Тип: string optional
URL-адрес профиля рецензента. Это значение будет undefined , если профиль рецензента недоступен.
rating optional
Тип: number optional
Рейтинг данного обзора, число от 1,0 до 5,0 (включительно).
,

Класс PlacesService

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

Содержит методы, связанные с поиском мест и получением сведений о месте.

Получите доступ, вызвав const {PlacesService} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

PlacesService
PlacesService(attrContainer)
Параметры:
Создает новый экземпляр PlacesService , который отображает атрибуты в указанном контейнере.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест по номеру телефона. В большинстве случаев в списке результатов должен быть только один элемент, однако, если запрос неоднозначен, может быть возвращено более одного результата. PlaceResult , переданные обратному вызову, являются подмножествами полного PlaceResult . Ваше приложение может получить более подробный PlaceResult для каждого места, вызвав PlacesService.getDetails и передав PlaceResult.place_id для нужного места.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест на основе строки запроса. В большинстве случаев в списке результатов должен быть только один элемент, однако, если запрос неоднозначен, может быть возвращено более одного результата. PlaceResult , переданные обратному вызову, являются подмножествами полного PlaceResult . Ваше приложение может получить более подробный PlaceResult для каждого места, вызвав PlacesService.getDetails и передав PlaceResult.place_id для нужного места.
getDetails
getDetails(request, callback)
Параметры:
Возвращаемое значение: нет
Извлекает сведения о месте, указанном по заданному placeId .
nearbySearch
nearbySearch(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест рядом с определенным местом на основе ключевого слова или типа. Расположение всегда должно быть указано либо путем передачи LatLngBounds , либо параметров location и radius . PlaceResult , передаваемые обратному вызову, являются подмножествами полного PlaceResult . Ваше приложение может получить более подробный PlaceResult для каждого места, отправив запрос Place Details , передав PlaceResult.place_id для нужного места. Объект PlaceSearchPagination можно использовать для получения дополнительных страниц результатов (null, если это последняя страница результатов или если есть только одна страница результатов).
textSearch
textSearch(request, callback)
Параметры:
Возвращаемое значение: нет
Получает список мест на основе строки запроса (например, "пицца в Нью-Йорке" или "обувные магазины недалеко от Оттавы"). Параметры местоположения необязательны; когда местоположение указано, результаты смещаются только в сторону ближайших результатов, а не ограничиваются местами внутри области. Используйте textSearch , когда вы хотите искать места, используя произвольную строку, и в случаях, когда вы не хотите ограничивать результаты поиска определенным местоположением. Объект PlaceSearchPagination можно использовать для получения дополнительных страниц результатов (null, если это последняя страница результатов или если есть только одна страница результатов).

Интерфейс PlaceDetailsRequest

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

Запрос сведений о месте для отправки в PlacesService .

placeId
Тип: string
Идентификатор места, сведения о котором запрашиваются.
fields optional
Тип: Array <string> optional
Поля, которые должны быть включены в подробный ответ, за который будет выставлен счет . Если поля не указаны или передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены сведения. См. список поддерживаемых языков .
region optional
Тип: string optional
Региональный код региона пользователя. Это может повлиять на то, какие фотографии могут быть возвращены, и, возможно, на другие вещи. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Соединенного Королевства — «uk» ( .co.uk ), а его код ISO 3166-1 — «gb» (технически для субъекта «Соединенное Королевство Великобритании и Северной Ирландии»).
sessionToken optional
Тип: AutocompleteSessionToken optional
Уникальная ссылка, используемая для связывания запроса сведений с сеансом автозаполнения.

Интерфейс FindPlaceFromPhoneNumberRequest

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

Поиск места из запроса текстового поиска для отправки в PlacesService.findPlaceFromPhoneNumber .

fields
Тип: Array <string>
Поля, которые должны быть включены в ответ, за который будет взиматься плата . Если передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
phoneNumber
Тип: string
Номер телефона места для поиска. Формат должен быть E.164 .
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
locationBias optional
Тип: LocationBias optional
Смещение, используемое при поиске места. Результат будет смещен в сторону заданного LocationBias , но не ограничиваться им.

Интерфейс FindPlaceFromQueryRequest

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

Место поиска из запроса текстового поиска для отправки в PlacesService.findPlaceFromQuery .

fields
Тип: Array <string>
Поля, которые должны быть включены в ответ, за который будет взиматься плата . Если передано ['ALL'] , все доступные поля будут возвращены и за них будет выставлен счет (это не рекомендуется для производственных развертываний). Список полей см. в PlaceResult . Вложенные поля можно указать с помощью точечных путей (например, "geometry.location" ).
query
Тип: string
Запрос запроса. Например, название или адрес места.
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
locationBias optional
Тип: LocationBias optional
Смещение, используемое при поиске места. Результат будет смещен в сторону заданного LocationBias , но не ограничиваться им.

Интерфейс PlaceSearchRequest

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

Запрос поиска места для отправки в PlacesService .

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Границы, в которых следует искать Places. И location , и radius будут игнорироваться, если установлены bounds .
keyword optional
Тип: string optional
Термин, который должен сопоставляться со всеми доступными полями, включая, помимо прочего, имя, тип и адрес, а также отзывы клиентов и другой сторонний контент.
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены имена и адреса, когда это возможно. См. список поддерживаемых языков .
location optional
Тип: LatLng | LatLngLiteral optional
Местоположение, вокруг которого следует искать Places.
maxPriceLevel optional
Тип: number optional
Ограничивает результаты только теми местами с указанным ценовым уровнем или ниже. Допустимые значения находятся в диапазоне от 0 (самый доступный) до 4 (самый дорогой) включительно. Должно быть больше или равно minPrice , если указано.
minPriceLevel optional
Тип: number optional
Ограничивает результаты только местами с указанным ценовым уровнем или выше. Допустимые значения находятся в диапазоне от 0 (самый доступный) до 4 (самый дорогой) включительно. Должно быть меньше или равно maxPrice , если указано.
name optional name optional
Тип: string optional
Эквивалент keyword . Значения в этом поле объединяются со значениями в поле keyword и передаются как часть той же строки поиска.
openNow optional
Тип: boolean optional
Ограничивает результаты только теми местами, которые открыты прямо сейчас.
radius optional
Тип: number optional
Расстояние от заданного местоположения, в пределах которого нужно искать места, в метрах. Максимально допустимое значение 50 000.
rankBy optional
Тип: RankBy optional
По умолчанию: RankBy.PROMINENCE
Указывает метод ранжирования, используемый при возврате результатов. Обратите внимание, что когда для rankBy установлено значение DISTANCE , вы должны указать location , но не можете указать radius или bounds .
type optional
Тип: string optional
Ищет места заданного типа. Тип переводится на местный язык целевого местоположения запроса и используется в качестве строки запроса. If a query is also provided, it is concatenated to the localized type string. Results of a different type are dropped from the response. Use this field to perform language and region independent categorical searches. Valid types are given here .

TextSearchRequest interface

google.maps.places . TextSearchRequest interface

A text search request to be sent to the PlacesService .

bounds optional
Тип: LatLngBounds | LatLngBoundsLiteral optional
Bounds used to bias results when searching for Places (optional). Both location and radius will be ignored if bounds is set. Results will not be restricted to those inside these bounds; but, results inside it will rank higher.
language optional
Тип: string optional
A language identifier for the language in which names and addresses should be returned, when possible. See the list of supported languages .
location optional
Тип: LatLng | LatLngLiteral optional
The center of the area used to bias results when searching for Places.
query optional
Тип: string optional
The request's query term. For example, the name of a place ('Eiffel Tower'), a category followed by the name of a location ('pizza in New York'), or the name of a place followed by a location disambiguator ('Starbucks in Sydney').
radius optional
Тип: number optional
The radius of the area used to bias results when searching for Places, in meters.
region optional
Тип: string optional
A region code to bias results towards. The region code accepts a ccTLD ("top-level domain") two-character value. Most ccTLD codes are identical to ISO 3166-1 codes, with some notable exceptions. For example, the United Kingdom's ccTLD is "uk" ( .co.uk ) while its ISO 3166-1 code is "gb" (technically for the entity of "The United Kingdom of Great Britain and Northern Ireland").
type optional
Тип: string optional
Searches for places of the given type. The type is translated to the local language of the request's target location and used as a query string. If a query is also provided, it is concatenated to the localized type string. Results of a different type are dropped from the response. Use this field to perform language and region independent categorical searches. Valid types are given here .

RankBy constants

google.maps.places . RankBy constants

Ranking options for a PlaceSearchRequest.

Access by calling const {RankBy} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

DISTANCE Ranks place results by distance from the location.
PROMINENCE Ranks place results by their prominence.

LocationBias typedef

google.maps.places . LocationBias typedef

A LocationBias represents a soft boundary or hint to use when searching for Places. Results may come from outside the specified area. To use the current user's IP address as a bias, the string "IP_BIAS" can be specified. Note: if using a Circle the center and radius must be defined.

LatLng | LatLngLiteral | LatLngBounds | LatLngBoundsLiteral | Circle | CircleLiteral |string

LocationRestriction typedef

google.maps.places . LocationRestriction typedef

A LocationRestriction represents a strict boundary to use when searching for Places.

LatLngBounds | LatLngBoundsLiteral

PlacesServiceStatus constants

google.maps.places . PlacesServiceStatus constants

The status returned by the PlacesService on the completion of its searches. Specify these by value, or by using the constant's name. For example, 'OK' or google.maps.places.PlacesServiceStatus.OK .

Access by calling const {PlacesServiceStatus} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

INVALID_REQUEST This request was invalid.
NOT_FOUND The place referenced was not found.
OK The response contains a valid result.
OVER_QUERY_LIMIT The application has gone over its request quota.
REQUEST_DENIED The application is not allowed to use the PlacesService .
UNKNOWN_ERROR The PlacesService request could not be processed due to a server error. The request may succeed if you try again.
ZERO_RESULTS No result was found for this request.

PlaceSearchPagination interface

google.maps.places . PlaceSearchPagination interface

An object used to fetch additional pages of Places results.

hasNextPage
Type: boolean
Indicates if further results are available. true when there is an additional results page.
nextPage
nextPage()
Параметры: Нет
Возвращаемое значение: нет
Fetches the next page of results. Uses the same callback function that was provided to the first search request.

PlaceResult interface

google.maps.places . PlaceResult interface

Defines information about a Place.

address_components optional
Type: Array < GeocoderAddressComponent > optional
The collection of address components for this Place's location. Only available with PlacesService.getDetails .
adr_address optional
Тип: string optional
The representation of the Place's address in the adr microformat . Only available with PlacesService.getDetails .
aspects optional
Type: Array < PlaceAspectRating > optional
The rated aspects of this Place, based on Google and Zagat user reviews. The ratings are on a scale of 0 to 30.
business_status optional
Type: BusinessStatus optional
A flag indicating the operational status of the Place, if it is a business (indicates whether the place is operational, or closed either temporarily or permanently). If no data is available, the flag is not present in search or details responses.
formatted_address optional
Тип: string optional
The Place's full address.
formatted_phone_number optional
Тип: string optional
The Place's phone number, formatted according to the number's regional convention . Only available with PlacesService.getDetails .
geometry optional
Type: PlaceGeometry optional
The Place's geometry-related information.
html_attributions optional
Type: Array <string> optional
Attribution text to be displayed for this Place result. Available html_attributions are always returned regardless of what fields have been requested, and must be displayed.
icon optional
Тип: string optional
URL to an image resource that can be used to represent this Place's category.
icon_background_color optional
Тип: string optional
Background color for use with a Place's icon. See also PlaceResult.icon_mask_base_uri .
icon_mask_base_uri optional
Тип: string optional
A truncated URL to an icon mask. Access different icon types by appending a file extension to the end (ie .svg or .png ).
international_phone_number optional
Тип: string optional
The Place's phone number in international format. International format includes the country code, and is prefixed with the plus (+) sign. Only available with PlacesService.getDetails .
name optional
Тип: string optional
The Place's name. Note: In the case of user entered Places, this is the raw text, as typed by the user. Please exercise caution when using this data, as malicious users may try to use it as a vector for code injection attacks (See http://en.wikipedia.org/wiki/Code_injection ).
opening_hours optional
Type: PlaceOpeningHours optional
Defines when the Place opens or closes.
permanently_closed optional permanently_closed optional
Тип: boolean optional
A flag indicating whether the Place is closed, either permanently or temporarily. If the place is operational, or if no data is available, the flag is absent from the response.
photos optional
Type: Array < PlacePhoto > optional
Photos of this Place. The collection will contain up to ten PlacePhoto objects.
place_id optional
Тип: string optional
A unique identifier for the Place.
plus_code optional
Type: PlacePlusCode optional
Defines Open Location Codes or " plus codes " for the Place.
price_level optional
Тип: number optional
The price level of the Place, on a scale of 0 to 4. Price levels are interpreted as follows:
  • 0 : Free
  • 1 : Inexpensive
  • 2 : Moderate
  • 3 : Expensive
  • 4 : Very Expensive
rating optional
Тип: number optional
A rating, between 1.0 to 5.0, based on user reviews of this Place.
reviews optional
Type: Array < PlaceReview > optional
A list of reviews of this Place. Only available with PlacesService.getDetails .
types optional
Type: Array <string> optional
An array of types for this Place (for example, ["political", "locality"] or ["restaurant", "establishment"] ).
url optional
Тип: string optional
URL of the official Google page for this place. This is the Google-owned page that contains the best available information about the Place. Only available with PlacesService.getDetails .
user_ratings_total optional
Тип: number optional
The number of user ratings which contributed to this Place's PlaceResult.rating .
utc_offset optional utc_offset optional
Тип: number optional
The offset from UTC of the Place's current timezone, in minutes. For example, Sydney, Australia in daylight savings is 11 hours ahead of UTC, so the utc_offset will be 660 . For timezones behind UTC, the offset is negative. For example, the utc_offset is -60 for Cape Verde. Only available with PlacesService.getDetails .
utc_offset_minutes optional
Тип: number optional
The offset from UTC of the Place's current timezone, in minutes. For example, Sydney, Australia in daylight savings is 11 hours ahead of UTC, so the utc_offset_minutes will be 660 . For timezones behind UTC, the offset is negative. For example, the utc_offset_minutes is -60 for Cape Verde. Only available with PlacesService.getDetails .
vicinity optional
Тип: string optional
The simplified address for the Place, including the street name, street number, and locality, but not the province/state, postal code, or country. For example, Google's Sydney, Australia office has a vicinity value of "48 Pirrama Road, Pyrmont" . Only available with PlacesService.getDetails .
website optional
Тип: string optional
The authoritative website for this Place, such as a business' homepage. Only available with PlacesService.getDetails .

PlaceAspectRating interface

google.maps.places . PlaceAspectRating interface

Defines information about an aspect of the place that users have reviewed.

rating
Type: number
The rating of this aspect. For individual reviews this is an integer from 0 to 3. For aggregated ratings of a place this is an integer from 0 to 30.
type
Type: string
The aspect type. For example, "food" , "decor" , "service" , or "overall" .

BusinessStatus constants

google.maps.places . BusinessStatus constants

The operational status of the Place, if it is a business, returned in a PlaceResult (indicates whether the place is operational, or closed either temporarily or permanently). Specify these by value, or the constant's name (example: 'OPERATIONAL' or google.maps.places.BusinessStatus.OPERATIONAL ).

Access by calling const {BusinessStatus} = await google.maps.importLibrary("places") . См. Библиотеки в Maps JavaScript API .

CLOSED_PERMANENTLY The business is closed permanently.
CLOSED_TEMPORARILY The business is closed temporarily.
OPERATIONAL The business is operating normally.

PlaceGeometry interface

google.maps.places . PlaceGeometry interface

Defines information about the geometry of a Place.

location optional
Type: LatLng optional
The Place's position.
viewport optional
Type: LatLngBounds optional
The preferred viewport when displaying this Place on a map. This property will be null if the preferred viewport for the Place is not known. Only available with PlacesService.getDetails .

PlaceOpeningHours interface

google.maps.places . PlaceOpeningHours interface

Defines information about the opening hours of a Place.

open_now optional open_now optional
Тип: boolean optional
Whether the Place is open at the current time.
periods optional
Type: Array < PlaceOpeningHoursPeriod > optional
Opening periods covering for each day of the week, starting from Sunday, in chronological order. Days in which the Place is not open are not included. Only available with PlacesService.getDetails .
weekday_text optional
Type: Array <string> optional
An array of seven strings representing the formatted opening hours for each day of the week. The Places Service will format and localize the opening hours appropriately for the current language. The ordering of the elements in this array depends on the language. Some languages start the week on Monday while others start on Sunday. Only available with PlacesService.getDetails . Other calls may return an empty array.
isOpen
isOpen([date])
Параметры:
  • date : Date optional
Return Value: boolean|undefined
Check whether the place is open now (when no date is passed), or at the given date. If this place does not have PlaceResult.utc_offset_minutes or PlaceOpeningHours.periods then undefined is returned ( PlaceOpeningHours.periods is only available via PlacesService.getDetails ). This method does not take exceptional hours, such as holiday hours, into consideration.

PlaceOpeningHoursPeriod interface

google.maps.places . PlaceOpeningHoursPeriod interface

Defines structured information about the opening hours of a Place. Note: If a Place is always open , the close section will be missing from the response. Clients can rely on always-open being represented as an open period containing day with value 0 and time with value "0000" , and no close .

open
The opening time for the Place.
close optional
Type: PlaceOpeningHoursTime optional
The closing time for the Place.

PlaceOpeningHoursTime interface

google.maps.places . PlaceOpeningHoursTime interface

Defines when a Place opens or closes.

day
Type: number
The days of the week, as a number in the range [ 0 , 6 ], starting on Sunday. For example, 2 means Tuesday.
hours
Type: number
The hours of the PlaceOpeningHoursTime.time as a number, in the range [ 0 , 23 ]. This will be reported in the Place's time zone.
minutes
Type: number
The minutes of the PlaceOpeningHoursTime.time as a number, in the range [ 0 , 59 ]. This will be reported in the Place's time zone.
time
Type: string
The time of day in 24-hour "hhmm" format. Values are in the range [ "0000" , "2359" ]. The time will be reported in the Place's time zone.
nextDate optional
Тип: number optional
The timestamp (as milliseconds since the epoch, suitable for use with new Date() ) representing the next occurrence of this PlaceOpeningHoursTime. It is calculated from the PlaceOpeningHoursTime.day of week, the PlaceOpeningHoursTime.time , and the PlaceResult.utc_offset_minutes . If the PlaceResult.utc_offset_minutes is undefined , then nextDate will be undefined .

PlacePlusCode interface

google.maps.places . PlacePlusCode interface

Defines Open Location Codes or " plus codes " for a Place. Plus codes can be used as a replacement for street addresses in places where they do not exist (where buildings are not numbered or streets are not named).

global_code
Type: string
A plus code with a 1/8000th of a degree by 1/8000th of a degree area. For example, "8FVC9G8F+5W" .
compound_code optional
Тип: string optional
A plus code with a 1/8000th of a degree by 1/8000th of a degree area where the first four characters (the area code) are dropped and replaced with a locality description. For example, "9G8F+5W Zurich, Switzerland" . If no suitable locality that can be found to shorten the code then this field is omitted.

PlacePhoto interface

google.maps.places . PlacePhoto interface

Represents a photo element of a Place.

height
Type: number
The height of the photo in pixels.
html_attributions
Type: Array <string>
Attribution text to be displayed for this photo.
width
Type: number
The width of the photo in pixels.
getUrl
getUrl([opts])
Параметры:
Return Value: string
Returns the image URL corresponding to the specified options.

PhotoOptions interface

google.maps.places . PhotoOptions interface

Defines photo-requesting options.

maxHeight optional
Тип: number optional
The maximum height in pixels of the returned image.
maxWidth optional
Тип: number optional
The maximum width in pixels of the returned image.

PlaceReview interface

google.maps.places . PlaceReview interface

Represents a single review of a place.

author_name
Type: string
The name of the reviewer.
language
Type: string
An IETF language code indicating the language in which this review is written. Note that this code includes only the main language tag without any secondary tag indicating country or region. For example, all the English reviews are tagged as 'en' rather than 'en-AU' or 'en-UK'.
profile_photo_url
Type: string
A URL to the reviwer's profile image.
relative_time_description
Type: string
A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country. For example "a month ago" .
text
Type: string
The text of a review.
time
Type: number
Timestamp for the review, expressed in seconds since epoch.
aspects optional aspects optional
Type: Array < PlaceAspectRating > optional
The aspects rated by the review. The ratings on a scale of 0 to 3.
author_url optional
Тип: string optional
A URL to the reviewer's profile. This will be undefined when the reviewer's profile is unavailable.
rating optional
Тип: number optional
The rating of this review, a number between 1.0 and 5.0 (inclusive).