Класс PlacesService
class
google.maps.places.PlacesService
library "places"
Содержит методы, связанные с поиском мест и получением сведений о них.
const {PlacesService} = await google.maps.importLibrary("places");
Конструктор | |
|---|---|
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 для каждого места, приложение может отправить запрос информации о местах, передав PlaceResult.place_id для нужного места. Объект PlaceSearchPagination можно использовать для получения дополнительных страниц с результатами (значение null, если это последняя страница с результатами или если страница с результатами только одна). |
textSearch |
textSearch(request, callback)Параметры:
Возвращаемое значение: нет.
Получает список мест на основе строки запроса (например, "пицца в Нью-Йорке" или "обувные магазины рядом с Оттавой"). Параметры местоположения необязательны. Если местоположение указано, результаты будут смещены в сторону ближайших результатов, а не ограничены местами внутри области. Используйте textSearch, если хотите искать места по произвольной строке и не хотите ограничивать результаты поиска определенным местоположением. Объект PlaceSearchPagination можно использовать для получения дополнительных страниц с результатами (имеет значение null, если это последняя или единственная страница с результатами). |
Интерфейс PlaceDetailsRequest
интерфейс
google.maps.places.PlaceDetailsRequest
Запрос информации о местах, который будет отправлен в PlacesService.
Свойства | |
|---|---|
placeId |
Тип:
stringИдентификатор места, для которого запрашиваются сведения. |
fields
необязательно |
Тип:
Array<string> optionalПоля, которые будут включены в ответ с подробными сведениями и за которые будет взиматься плата. Если поля не указаны или передается ['ALL'], будут возвращены все доступные поля, и за них будет взиматься оплата (не рекомендуется для рабочих развертываний). Список полей приведен в статье о PlaceResult. Вложенные поля можно указать с помощью путей с точками (например, "geometry.location"). |
language
необязательно |
Тип:
string optionalИдентификатор языка, на котором должны быть возвращены сведения. Вы можете ознакомиться со списком поддерживаемых языков. |
region
необязательно |
Тип:
string optionalКод региона пользователя. Это может повлиять на то, какие фотографии будут возвращены, и, возможно, на другие вещи. Код региона указывается в виде двух буквенных символов ccTLD (домен верхнего уровня). Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – uk ( .co.uk), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии). |
sessionToken
необязательно |
Тип:
AutocompleteSessionToken optionalУникальный идентификатор, используемый для объединения запроса сведений с сеансом автозаполнения. |
Интерфейс FindPlaceFromPhoneNumberRequest
интерфейс
google.maps.places.FindPlaceFromPhoneNumberRequest
Запрос на поиск места по текстовому поиску, который будет отправлен в PlacesService.findPlaceFromPhoneNumber.
Свойства | |
|---|---|
fields |
Тип:
Array<string>Поля, которые будут включены в ответ и за которые будет взиматься плата. Если передается ['ALL'], будут возвращены все доступные поля, и за них будет взиматься оплата (не рекомендуется для рабочих развертываний). Список полей приведен в статье о PlaceResult. Вложенные поля можно указать с помощью путей с точками (например, "geometry.location"). |
phoneNumber |
Тип:
stringНомер телефона места, которое нужно найти. Формат должен быть E.164. |
language
необязательно |
Тип:
string optionalИдентификатор языка, на котором по возможности должны возвращаться названия и адреса. Вы можете ознакомиться со списком поддерживаемых языков. |
locationBias
необязательно |
Тип:
LocationBias optionalСмещение, используемое при поиске места. Результаты будут подбираться с учетом указанного значения LocationBias, но не ограничиваться им. |
Интерфейс FindPlaceFromQueryRequest
интерфейс
google.maps.places.FindPlaceFromQueryRequest
Запрос на поиск места по текстовому поиску, который будет отправлен в PlacesService.findPlaceFromQuery.
Свойства | |
|---|---|
fields |
Тип:
Array<string>Поля, которые будут включены в ответ и за которые будет взиматься плата. Если передается ['ALL'], будут возвращены все доступные поля, и за них будет взиматься оплата (не рекомендуется для рабочих развертываний). Список полей приведен в статье о PlaceResult. Вложенные поля можно указать с помощью путей с точками (например, "geometry.location"). |
query |
Тип:
stringЗапрос. например название или адрес места. |
language
необязательно |
Тип:
string optionalИдентификатор языка, на котором по возможности должны возвращаться названия и адреса. Вы можете ознакомиться со списком поддерживаемых языков. |
locationBias
необязательно |
Тип:
LocationBias optionalСмещение, используемое при поиске места. Результаты будут подбираться с учетом указанного значения LocationBias, но не ограничиваться им. |
Интерфейс PlaceSearchRequest
интерфейс
google.maps.places.PlaceSearchRequest
Поисковый запрос, который будет отправлен в PlacesService.
Свойства | |
|---|---|
bounds
необязательно |
Тип:
LatLngBounds|LatLngBoundsLiteral optionalГраницы, в пределах которых выполняется поиск мест. Если задано свойство bounds, то свойства location и radius будут игнорироваться. |
keyword
необязательно |
Тип:
string optionalКлючевое слово, по которому ведется поиск во всех доступных полях, включая, помимо прочего, название, тип, адрес, а также отзывы клиентов и сторонний контент. |
language
необязательно |
Тип:
string optionalИдентификатор языка, на котором по возможности должны возвращаться названия и адреса. Вы можете ознакомиться со списком поддерживаемых языков. |
location
необязательно |
Тип:
LatLng|LatLngLiteral optionalМесто, вокруг которого нужно искать объекты. |
maxPriceLevel
необязательно |
Тип:
number optionalОграничивает результаты местами, которые соответствуют указанному уровню цен или ниже. Значения могут находится в диапазоне от 0 (наиболее доступные места) до 4 (наиболее дорогие места). Если указано, значение должно быть больше или равно minPrice . |
minPriceLevel
необязательно |
Тип:
number optionalОграничивает результаты местами, которые соответствуют указанному уровню цен или выше. Значения могут находится в диапазоне от 0 (наиболее доступные места) до 4 (наиболее дорогие места). Если указано, значение должно быть меньше или равно maxPrice. |
необязательно |
Тип:
string optionalАналогичен элементу keyword. Значения из этого поля объединяются со значениями поля keyword и передаются в составе той же строки поиска. |
openNow
необязательно |
Тип:
boolean optionalОграничивает результаты только теми местами, которые открыты прямо сейчас. |
radius
необязательно |
Тип:
number optionalРасстояние в метрах от указанного местоположения, в пределах которого нужно искать места. Максимально допустимое значение – 50 000. |
rankBy
необязательно |
Тип:
RankBy optionalПо умолчанию:
RankBy.PROMINENCE.Указывает метод ранжирования, который будет использоваться при возврате результатов. Обратите внимание, что если для параметра rankBy задано значение DISTANCE, нужно обязательно указать location, но нельзя указать radius или bounds. |
type
необязательно |
Тип:
string optionalПоиск мест заданного типа. Тип переводится на язык, используемый в целевом местоположении запроса, и используется в качестве строки запроса. Если также указан запрос, он объединяется с локализованной строкой типа. Результаты другого типа удаляются из ответа. Используйте это поле для поиска по категориям, не зависящим от языка и региона. Допустимые типы перечислены здесь. |
Интерфейс TextSearchRequest
интерфейс
google.maps.places.TextSearchRequest
Запрос текстового поиска, который будет отправлен в PlacesService.
Свойства | |
|---|---|
bounds
необязательно |
Тип:
LatLngBounds|LatLngBoundsLiteral optionalГраницы, используемые для уточнения результатов при поиске мест (необязательно). Если задано свойство bounds, то свойства location и radius будут игнорироваться. Результаты не будут ограничены только теми, которые находятся в этих границах, но результаты внутри них будут ранжироваться выше. |
language
необязательно |
Тип:
string optionalИдентификатор языка, на котором по возможности должны возвращаться названия и адреса. Вы можете ознакомиться со списком поддерживаемых языков. |
location
необязательно |
Тип:
LatLng|LatLngLiteral optionalЦентр области, используемой для смещения результатов при поиске мест. |
query
необязательно |
Тип:
string optionalПоисковый запрос. Например, название места ("Эйфелева башня"), категория и название местоположения ("пицца в Нью-Йорке") или название места и уточнение местоположения ("Старбакс в Сиднее"). |
radius
необязательно |
Тип:
number optionalРадиус области, используемой для смещения результатов при поиске мест, в метрах. |
region
необязательно |
Тип:
string optionalКод региона, результаты из которого будут показываться в первую очередь. Код региона указывается в виде двух буквенных символов ccTLD (домен верхнего уровня). Большинство кодов ccTLD идентичны кодам ISO 3166-1 с некоторыми существенными исключениями. Например, ccTLD Великобритании – uk ( .co.uk), а код ISO 3166-1 – gb (технически для Соединенного Королевства Великобритании и Северной Ирландии). |
type
необязательно |
Тип:
string optionalПоиск мест заданного типа. Тип переводится на язык, используемый в целевом местоположении запроса, и используется в качестве строки запроса. Если также указан запрос, он объединяется с локализованной строкой типа. Результаты другого типа удаляются из ответа. Используйте это поле для поиска по категориям, не зависящим от языка и региона. Допустимые типы перечислены здесь. |
Константы RankBy
константы
google.maps.places.RankBy
библиотека "places"
Варианты ранжирования для PlaceSearchRequest.
const {RankBy} = await google.maps.importLibrary("places");
Константы | |
|---|---|
DISTANCE |
Результаты ранжируются по расстоянию от указанного местоположения. |
PROMINENCE |
Результаты ранжируются по известности. |
typedef LocationBias
typedef
google.maps.places.LocationBias
LocationBias представляет собой мягкую границу или подсказку, которую следует использовать при поиске мест. Результаты могут быть за пределами указанной области. Чтобы использовать IP-адрес текущего пользователя в качестве смещения, можно указать строку "IP_BIAS". Примечание. Если вы используете Circle, необходимо указать центр и радиус.
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
typedef
google.maps.places.LocationRestriction
Объект LocationRestriction представляет собой строгую границу, которая используется при поиске мест.
Константы PlacesServiceStatus
константы
google.maps.places.PlacesServiceStatus
библиотека "places"
Статус, возвращаемый PlacesService по завершении поиска. Укажите их по значению или по названию константы. Примеры: 'OK' или google.maps.places.PlacesServiceStatus.OK.
Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом PlacesServiceStatusString.
const {PlacesServiceStatus} = await google.maps.importLibrary("places");
Константы | |
|---|---|
INVALID_REQUEST |
Недопустимый запрос. |
NOT_FOUND |
Указанное место не найдено. |
OK |
Ответ содержит действительный результат. |
OVER_QUERY_LIMIT |
Приложение превысило квоту на запросы. |
REQUEST_DENIED |
Приложению запрещено использовать PlacesService. |
UNKNOWN_ERROR |
Запрос PlacesService не удалось обработать из-за ошибки сервера. Если повторить попытку, запрос может оказаться успешным. |
ZERO_RESULTS |
для этого запроса не найдено результатов. |
Интерфейс PlaceSearchPagination
интерфейс
google.maps.places.PlaceSearchPagination
Объект, используемый для получения дополнительных страниц результатов поиска мест.
Свойства | |
|---|---|
hasNextPage |
Тип:
booleanУказывает, доступны ли дополнительные результаты. Имеет значение true, если существуют дополнительные результаты. |
Методы | |
|---|---|
nextPage |
nextPage()Параметры: нет.
Возвращаемое значение:
voidПолучает следующую страницу результатов. Использует ту же функцию обратного вызова, которая была предоставлена для первого поискового запроса. |
Интерфейс PlaceResult
интерфейс
google.maps.places.PlaceResult
Определяет информацию о месте.
Свойства | |
|---|---|
address_components
необязательно |
Тип:
Array<GeocoderAddressComponent> optionalНабор компонентов адреса для местоположения этого места. Доступно только по подписке PlacesService.getDetails. |
adr_address
необязательно |
Тип:
string optionalАдрес места в микроформате adr. Доступно только по подписке PlacesService.getDetails. |
aspects
необязательно |
Тип:
Array<Оценки места по различным критериям, основанные на отзывах пользователей Google и Zagat. Оценки выставляются по шкале от 0 до 30. |
business_status
необязательно |
Тип:
BusinessStatus optionalПометка, указывающая, работает ли место, если оно является компанией (указывает, работает ли место или закрыто временно или навсегда). Если данных нет, флаг не будет присутствовать в ответах на запросы поиска или описания. |
formatted_address
необязательно |
Тип:
string optionalПолный адрес места. |
formatted_phone_number
необязательно |
Тип:
string optionalНомер телефона места в формате, соответствующем региональным правилам нумерации. Доступно только по подписке PlacesService.getDetails. |
geometry
необязательно |
Тип:
PlaceGeometry optionalГеометрические характеристики места. |
html_attributions
необязательно |
Тип:
Array<string> optionalТекст атрибуции, отображаемый для этого результата Places. Доступные html_attributions всегда возвращаются независимо от того, какие fields были запрошены, и должны быть показаны. |
icon
необязательно |
Тип:
string optionalURL изображения, которое можно использовать для представления категории этого места. |
icon_background_color
необязательно |
Тип:
string optionalЦвет фона для значка места. Дополнительные сведения: PlaceResult.icon_mask_base_uri. |
icon_mask_base_uri
необязательно |
Тип:
string optionalУсеченный URL маски значка. Чтобы получить доступ к разным типам значков, добавьте в конце расширение имени файла (например, .svg или .png). |
international_phone_number
необязательно |
Тип:
string optionalНомер телефона места в международном формате. Международный формат включает код страны и префикс в виде знака "плюс" (+). Доступно только по подписке PlacesService.getDetails. |
name
необязательно |
Тип:
string optionalНазвание места. Примечание. Если место введено пользователем, это будет необработанный текст, введенный пользователем. Будьте осторожны при использовании этих данных, так как злоумышленники могут попытаться использовать их для атак с внедрением кода (см. http://en.wikipedia.org/wiki/Code_injection). |
opening_hours
необязательно |
Тип:
PlaceOpeningHours optionalОпределяет, когда место открывается или закрывается. |
необязательно |
Тип:
boolean optionalФлаг, указывающий, закрыто ли место временно или навсегда. Если место работает или данных нет, пометка в ответе отсутствует. |
photos
необязательно |
Тип:
Array<PlacePhoto> optionalФотографии этого места. Коллекция будет содержать до десяти объектов PlacePhoto. |
place_id
необязательно |
Тип:
string optionalУникальный идентификатор места. |
plus_code
необязательно |
Тип:
PlacePlusCode optionalОпределяет коды Open Location Code или коды Plus Code для места. |
price_level
необязательно |
Тип:
number optionalУровень цен в месте по шкале от 0 до 4. Уровни цен интерпретируются следующим образом:
|
rating
необязательно |
Тип:
number optionalОценка места в диапазоне от 1,0 до 5,0, основанная на отзывах пользователей. |
reviews
необязательно |
Тип:
Array<PlaceReview> optionalСписок отзывов об этом месте. Доступно только по подписке PlacesService.getDetails. |
types
необязательно |
Тип:
Array<string> optionalМассив типов для этого места (например, ["political", "locality"] или ["restaurant", "establishment"]). |
url
необязательно |
Тип:
string optionalURL-адрес официальной страницы этого места в Google. Это страница Google, содержащая всю имеющуюся информацию об этом месте. Доступно только по подписке PlacesService.getDetails. |
user_ratings_total
необязательно |
Тип:
number optionalКоличество оценок пользователей, которые учитывались при расчете PlaceResult.rating для этого места. |
необязательно |
Тип:
number optionalСмещение текущего часового пояса места относительно UTC в минутах. Например, в Сиднее (Австралия) летнее время на 11 часов опережает UTC, поэтому значение utc_offset будет 660. Для часовых поясов, отстающих от UTC, смещение отрицательное. Например, для Кабо-Верде utc_offset – это -60. Доступно только по подписке PlacesService.getDetails. |
utc_offset_minutes
необязательно |
Тип:
number optionalСмещение текущего часового пояса места относительно UTC в минутах. Например, в Сиднее (Австралия) летнее время на 11 часов опережает UTC, поэтому значение utc_offset_minutes будет 660. Для часовых поясов, отстающих от UTC, смещение отрицательное. Например, для Кабо-Верде utc_offset_minutes – это -60. Доступно только по подписке PlacesService.getDetails. |
vicinity
необязательно |
Тип:
string optionalУпрощенный адрес места, включая населенный пункт, улицу и номер дома, но без указания штата, провинции или области, почтового индекса и страны. Например, для офиса Google в Сиднее (Австралия) параметр vicinity имеет значение "48 Pirrama Road, Pyrmont". Доступно только по подписке PlacesService.getDetails. |
website
необязательно |
Тип:
string optionalОфициальный сайт места, например главная страница компании. Доступно только по подписке PlacesService.getDetails. |
Интерфейс PlaceAspectRating
интерфейс
google.maps.places.PlaceAspectRating
Определяет информацию об аспекте места, которое пользователи оценили.
Свойства | |
|---|---|
rating |
Тип:
numberОценка по этому критерию. Для отдельных отзывов это целое число от 0 до 3. Для сводных оценок места это целое число от 0 до 30. |
type |
Тип:
stringТип аспекта. Примеры: "food", "decor", "service", "overall". |
Константы BusinessStatus
константы
google.maps.places.BusinessStatus
библиотека "places"
Статус компании. Дополнительную информацию можно найти в документации по веб-сервису.
Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом BusinessStatusString.
const {BusinessStatus} = await google.maps.importLibrary("places");
Константы | |
|---|---|
CLOSED_PERMANENTLY |
Заведение закрыто навсегда. Дополнительную информацию можно найти в документации по веб-сервису. |
CLOSED_TEMPORARILY |
Заведение временно закрыто. Дополнительную информацию можно найти в документации по веб-сервису. |
FUTURE_OPENING |
Заведение откроется в будущем. Дополнительную информацию можно найти в документации по веб-сервису. |
OPERATIONAL |
Заведение работает, но может быть закрыто в данный момент. Дополнительную информацию можно найти в документации по веб-сервису. |
Интерфейс PlaceGeometry
интерфейс
google.maps.places.PlaceGeometry
Определяет информацию о геометрии места.
Свойства | |
|---|---|
location
необязательно |
Тип:
LatLng optionalПозиция места. |
viewport
необязательно |
Тип:
LatLngBounds optionalПредпочтительная область просмотра при отображении этого места на карте. Если предпочтительная область просмотра для места неизвестна, это свойство будет иметь значение null. Доступно только по подписке PlacesService.getDetails. |
Интерфейс PlaceOpeningHours
интерфейс
google.maps.places.PlaceOpeningHours
Определяет информацию о часах работы места.
Свойства | |
|---|---|
необязательно |
Тип:
boolean optionalРаботает ли место в текущий момент. |
periods
необязательно |
Тип:
Array<PlaceOpeningHoursPeriod> optionalЧасы работы для каждого дня недели, начиная с воскресенья, в хронологическом порядке. Дни, когда место закрыто, не включаются. Доступно только по подписке PlacesService.getDetails. |
weekday_text
необязательно |
Тип:
Array<string> optionalМассив из семи строк, представляющих часы работы по дням недели в соответствующем формате. Сервис Places отформатирует и локализует часы работы соответствующим образом для текущего языка. Порядок элементов в этом массиве зависит от языка. В некоторых странах неделя начинается с понедельника, а в других началом недели считается воскресенье. Доступно только по подписке PlacesService.getDetails. Другие вызовы могут возвращать пустой массив. |
Методы | |
|---|---|
isOpen |
isOpen([date])Параметры:
Возвращаемое значение:
boolean|undefinedПроверьте, открыто ли место сейчас (если дата не указана) или в указанную дату. Если у места нет PlaceResult.utc_offset_minutes или PlaceOpeningHours.periods, возвращается undefined (PlaceOpeningHours.periods доступно только через PlacesService.getDetails). Этот метод не учитывает особые часы работы, например в праздничные дни. |
Интерфейс PlaceOpeningHoursPeriod
интерфейс
google.maps.places.PlaceOpeningHoursPeriod
Определяет структурированную информацию о часах работы места. Примечание. Если место работает круглосуточно, в ответе не будет раздела close. Можно уверенно считать, что место работает круглосуточно, если период open содержит параметр day, имеющий значение 0, параметр time, имеющий значение "0000", и при этом отсутствует параметр close.
Свойства | |
|---|---|
open |
Время открытия места. |
close
необязательно |
Тип:
PlaceOpeningHoursTime optionalВремя закрытия места. |
Интерфейс 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
необязательно |
Тип:
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
Определяет коды Open Location Code или коды Plus Code для места. Коды Plus Code можно использовать в качестве замены почтовым адресам там, где эти адреса не существуют (здания не пронумерованы или улицам не присвоены названия).
Свойства | |
|---|---|
global_code |
Тип:
stringКод Plus Code с областью 1/8000 градуса на 1/8000 градуса. Пример: "8FVC9G8F+5W". |
compound_code
необязательно |
Тип:
string optionalКод Plus Code с областью 1/8000 градуса на 1/8000 градуса, в котором первые четыре символа (код региона) удалены и заменены описанием местоположения. Пример: "9G8F+5W Zurich, Switzerland". Если подходящий населенный пункт не найден, это поле не заполняется. |
Интерфейс PlacePhoto
интерфейс
google.maps.places.PlacePhoto
Представляет элемент фотографии места.
Свойства | |
|---|---|
height |
Тип:
numberВысота фотографии в пикселях. |
html_attributions |
Тип:
Array<string>Текст атрибуции, отображаемый для этой фотографии. |
width |
Тип:
numberШирина фотографии в пикселях. |
Методы | |
|---|---|
getUrl |
getUrl([opts])Параметры:
Возвращаемое значение:
stringВозвращает URL изображения, соответствующий указанным параметрам. |
Интерфейс PhotoOptions
интерфейс
google.maps.places.PhotoOptions
Определяет параметры запроса фотографий.
Свойства | |
|---|---|
maxHeight
необязательно |
Тип:
number optionalМаксимальная высота возвращаемого изображения в пикселях. |
maxWidth
необязательно |
Тип:
number optionalМаксимальная ширина возвращаемого изображения в пикселях. |
Интерфейс PlaceReview
интерфейс
google.maps.places.PlaceReview
Представляет один отзыв о месте.
Свойства | |
|---|---|
author_name |
Тип:
stringИмя автора отзыва. |
language |
Тип:
stringКод языка IETF, указывающий язык, на котором написан отзыв. Обратите внимание, что этот код содержит только основной тег языка и не содержит дополнительный тег страны или региона. Например, все отзывы на английском языке имеют тег 'en', но не "en-AU" или "en-UK". |
profile_photo_url |
Тип:
stringURL изображения профиля автора отзыва. |
relative_time_description |
Тип:
stringСтрока с отформатированным временем, выражающая время отзыва относительно текущего времени в форме, соответствующей языку и стране. (пример: "a month ago"). |
text |
Тип:
stringТекст отзыва. |
time |
Тип:
numberВременная метка отзыва, выраженная в секундах с начала эпохи. |
необязательно |
Тип:
Array<Аспекты, оцененные в отзыве. Оценки по шкале от 0 до 3. |
author_url
необязательно |
Тип:
string optionalURL профиля автора отзыва. Если профиль автора отзыва недоступен, будет показано значение undefined. |
rating
необязательно |
Тип:
number optionalОценка в отзыве – число от 1,0 до 5,0 включительно. |