Элементы Advanced Place Details и Advanced Place Details Compact – это HTML-элементы, которые показывают информацию о месте.
-
AdvancedPlaceDetailsElementподдерживает все визуализируемые данные о месте и может включать несколько фотографий. -
AdvancedPlaceDetailsCompactElementзанимает минимум места и содержит краткую информацию о месте, включая название, адрес, оценку и т. д. Также может содержать одну фотографию.
Оба элемента предлагают одинаковые расширенные функции, включая настройку кнопок действий, скрытие названия места и фильтрацию отзывов и медиаконтента.
Используйте инструмент настройки, чтобы посмотреть, как разные наборы свойств влияют на внешний вид элемента с информацией о месте, и получить код на HTML/CSS, Kotlin/XML и Swift.
Элемент Advanced Place Details (предварительная версия)
Нажмите на маркер на карте, чтобы посмотреть информацию о месте в элементе расширенной информации о месте.
AdvancedPlaceDetailsElement поддерживает широкий спектр элементов контента, включая полные часы работы, сайт, номер телефона, сводку, созданную ИИ, с резервным вариантом в виде редакционной сводки, основные моменты, характерные для определенного типа, отзывы, сводку отзывов, созданную ИИ, плюс-код и списки функций.
Чтобы показывать на карте информацию о местах, добавьте элемент gmp-advanced-place-details в элемент gmp-map на HTML-странице. Добавьте дочерний элемент gmp-place-details-place-request, чтобы выбрать место. Это может быть объект Place, идентификатор места или название ресурса места:
<gmp-map center="47.759737, -122.250632" zoom="16" map-id="DEMO_MAP_ID">
<div class="widget-container" slot="control-inline-start-block-start">
<gmp-advanced-place-details>
<gmp-place-details-place-request place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
<gmp-place-all-content></gmp-place-all-content>
</gmp-advanced-place-details>
</div>
<gmp-advanced-marker></gmp-advanced-marker>
</gmp-map>Настройте контент
Вы можете управлять тем, какой контент о месте будет показываться в элементе gmp-advanced-place-details, вкладывая дочерние элементы для выбора и настройки информации о местах, как показано в следующем примере:
<gmp-advanced-place-details>
<gmp-place-details-place-request
place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
<gmp-place-name></gmp-place-name>
<gmp-place-address></gmp-place-address>
<gmp-place-rating></gmp-place-rating>
<gmp-place-type></gmp-place-type>
<gmp-place-price></gmp-place-price>
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>
<gmp-place-opening-hours></gmp-place-opening-hours>
<gmp-place-website></gmp-place-website>
<gmp-place-phone-number></gmp-place-phone-number>
<gmp-place-summary></gmp-place-summary>
<gmp-place-type-specific-highlights></gmp-place-type-specific-highlights>
<gmp-place-review-summary></gmp-place-review-summary>
<gmp-place-reviews></gmp-place-reviews>
<gmp-place-feature-list></gmp-place-feature-list>
<gmp-place-attribution></gmp-place-attribution>
</gmp-advanced-place-details>
Каждый дочерний элемент контента выбирает для показа соответствующую информацию о месте:
gmp-place-address
выбирает адрес места,
gmp-place-price
выбирает уровень цен места и т. д. Элементы
gmp-place-summary
и
gmp-place-review-summary
предоставляют краткий пересказ места и отзывов о нем, созданный на основе искусственного интеллекта. Порядок дочерних элементов не имеет значения, поскольку выбранные сведения всегда отображаются в фиксированном предопределенном порядке.
Некоторые из этих элементов можно дополнительно настроить с помощью атрибутов, относящихся к контенту:
-
Элемент
gmp-place-mediaиспользуется для показа одной фотографии и включает атрибутlightbox-preferred, который открывает фотографию в лайтбоксе при нажатии. По умолчанию Lightbox отключен. -
Элемент
gmp-place-attributionиспользуется для отображения общих настроек атрибуции данных Maps API, например источника фотографии или отзыва. Атрибутыlight-scheme-colorиdark-scheme-colorиспользуются для настройки цвета текста атрибуции в светлом и темном режимах.
Подробную информацию обо всех поддерживаемых элементах контента можно найти в справочной документации по настройке контента виджета Place.
Для простоты вы также можете использовать
gmp-place-all-content, чтобы показать все сведения, доступные в элементе Advanced Place Details, или
gmp-place-standard-content, чтобы показать стандартную конфигурацию.
Настройте внешний вид
Рекомендуемая ширина элемента gmp-advanced-place-details – от 250 до 400 пикселей. Если ширина меньше 250 пикселей, то объявление может показываться некорректно. Задайте высоту, подходящую для вашего приложения. Элемент Advanced Place Details поддерживает прокрутку в пределах отведенного пространства.
Элемент gmp-advanced-place-details также поддерживает различные пользовательские свойства CSS для настройки цветов и шрифтов. Подробнее о настройке стилей Places UI Kit…
Полный пример кода
TypeScript
// Use querySelector to select elements for interaction. const map = document.querySelector<google.maps.MapElement>('gmp-map')!; const placeDetails = document.querySelector< HTMLElement & { place?: google.maps.places.Place } >('gmp-advanced-place-details')!; const placeDetailsRequest = document.querySelector<HTMLElement>( 'gmp-place-details-place-request' )!; const marker = document.querySelector<google.maps.marker.AdvancedMarkerElement>( 'gmp-advanced-marker' )!; async function init(): Promise<void> { // Request needed libraries. await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('marker'), google.maps.importLibrary('places'), ]); // Hide the map type control. map.innerMap.setOptions({ mapTypeControl: false }); // Function to update map and marker based on place details const updateMapAndMarker = () => { if (placeDetails.place?.location) { map.innerMap.panTo(placeDetails.place.location); map.innerMap.setZoom(16); // Set zoom after panning if needed marker.position = placeDetails.place.location; marker.collisionBehavior = 'REQUIRED_AND_HIDES_OPTIONAL'; marker.style.display = 'block'; } }; // Set up map once widget is loaded. placeDetails.addEventListener('gmp-load', () => { updateMapAndMarker(); }); // Add an event listener to handle clicks. map.innerMap.addListener( 'click', (event: google.maps.MapMouseEvent | google.maps.IconMouseEvent) => { marker.position = null; event.stop(); if ('placeId' in event && event.placeId) { // Fire when the user clicks a POI. placeDetailsRequest.setAttribute( 'place', `places/${event.placeId}` ); updateMapAndMarker(); } else { // Fire when the user clicks the map (not on a POI). console.log('No place was selected.'); marker.style.display = 'none'; } } ); } void init();
JavaScript
// Use querySelector to select elements for interaction. const map = document.querySelector('gmp-map'); const placeDetails = document.querySelector('gmp-advanced-place-details'); const placeDetailsRequest = document.querySelector( 'gmp-place-details-place-request' ); const marker = document.querySelector('gmp-advanced-marker'); async function init() { // Request needed libraries. await Promise.all([ google.maps.importLibrary('maps'), google.maps.importLibrary('marker'), google.maps.importLibrary('places'), ]); // Hide the map type control. map.innerMap.setOptions({ mapTypeControl: false }); // Function to update map and marker based on place details const updateMapAndMarker = () => { if (placeDetails.place?.location) { map.innerMap.panTo(placeDetails.place.location); map.innerMap.setZoom(16); // Set zoom after panning if needed marker.position = placeDetails.place.location; marker.collisionBehavior = 'REQUIRED_AND_HIDES_OPTIONAL'; marker.style.display = 'block'; } }; // Set up map once widget is loaded. placeDetails.addEventListener('gmp-load', () => { updateMapAndMarker(); }); // Add an event listener to handle clicks. map.innerMap.addListener('click', (event) => { marker.position = null; event.stop(); if ('placeId' in event && event.placeId) { // Fire when the user clicks a POI. placeDetailsRequest.setAttribute( 'place', `places/${event.placeId}` ); updateMapAndMarker(); } else { // Fire when the user clicks the map (not on a POI). console.log('No place was selected.'); marker.style.display = 'none'; } }); } void init();
CSS
/* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } .container { display: flex; height: 100vh; width: 100%; } gmp-map { flex-grow: 1; } .ui-panel { width: 400px; margin-left: 20px; margin-top: 10px; } gmp-place-details { width: 100%; margin: 0; border: none; }
HTML
<!doctype html>
<html>
<head>
<title>Place Details with Google Maps</title>
<meta charset="utf-8" />
<link rel="stylesheet" type="text/css" href="style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY",
v: "beta"
});
</script>
</head>
<body>
<div class="container">
<!-- map-id is required to use advanced markers. See https://developers.google.com/maps/documentation/javascript/map-ids/mapid-over. -->
<gmp-map zoom="17" map-id="DEMO_MAP_ID">
<gmp-advanced-marker></gmp-advanced-marker>
</gmp-map>
<div class="ui-panel">
<gmp-advanced-place-details>
<gmp-place-details-place-request
place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
<gmp-place-name></gmp-place-name>
<gmp-place-address></gmp-place-address>
<gmp-place-rating></gmp-place-rating>
<gmp-place-type></gmp-place-type>
<gmp-place-price></gmp-place-price>
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>
<gmp-place-opening-hours></gmp-place-opening-hours>
<gmp-place-website></gmp-place-website>
<gmp-place-phone-number></gmp-place-phone-number>
<gmp-place-summary></gmp-place-summary>
<gmp-place-type-specific-highlights></gmp-place-type-specific-highlights>
<gmp-place-review-summary></gmp-place-review-summary>
<gmp-place-reviews></gmp-place-reviews>
<gmp-place-feature-list></gmp-place-feature-list>
</gmp-advanced-place-details>
</div>
</div>
</body>
</html>Компактный элемент улучшенной информации о местах (предварительная версия)
Нажмите на маркер на карте, чтобы посмотреть информацию о месте в компактном элементе с расширенными сведениями о месте.
AdvancedPlaceDetailsCompactElement показывает сведения о выбранном месте, занимая минимум места. Это может быть полезно в информационном окне, выделяющем место на карте, в социальных сетях, например при отправке местоположения в чате, в качестве предложения для выбора текущего местоположения или в статье СМИ для ссылки на место в Google Картах. В AdvancedPlaceDetailsCompactElement можно показывать название, адрес, оценку, тип, цену, значок специальных возможностей, статус работы и одну фотографию.
Она может быть горизонтальной или вертикальной в зависимости от значения атрибута orientation.
В следующем фрагменте кода для gmp-advanced-place-details-compact задано значение horizontal параметра orientation. Дополнительный атрибут truncation-preferred усекает определенный контент, чтобы он помещался в одну строку. Элемент gmp-advanced-place-details-compact содержит дочерний элемент gmp-place-details-place-request, который позволяет выбрать место.
Это может быть объект Place, идентификатор места или название ресурса места.
<gmp-advanced-place-details-compact orientation="horizontal" truncation-preferred>
<gmp-place-details-place-request place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
<gmp-place-all-content></gmp-place-all-content>
</gmp-advanced-place-details-compact>Настройте контент
Вы можете управлять тем, какой контент о месте будет показываться в элементе gmp-advanced-place-details-compact, вкладывая дочерние элементы для выбора и настройки информации о местах, как показано в этом фрагменте кода:
<gmp-advanced-place-details-compact>
<gmp-place-details-place-request place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
<gmp-place-photo></gmp-place-photo>
<gmp-place-name></gmp-place-name>
<gmp-place-rating></gmp-place-rating>
<gmp-place-address></gmp-place-address>
<gmp-place-opening-hours></gmp-place-opening-hours>
<gmp-place-attribution></gmp-place-attribution>
</gmp-advanced-place-details-compact>Каждый дочерний элемент контента выбирает для показа соответствующую информацию о месте. Порядок дочерних элементов не имеет значения, поскольку выбранные сведения всегда отображаются в фиксированном порядке. Некоторые из этих элементов можно дополнительно настроить с помощью атрибутов, относящихся к контенту.
Подробную информацию обо всех поддерживаемых элементах контента можно найти в справочной документации по настройке контента виджета Place.
Для простоты вы также можете использовать
gmp-place-all-content, чтобы показать все сведения, доступные в элементе Advanced Place Details Compact, или
gmp-place-standard-content, чтобы показать стандартную конфигурацию.
Настройте внешний вид
Рекомендуемая ширина элемента gmp-advanced-place-details-compact в вертикальной ориентации – от 180 до 300 пикселей. Если ширина меньше 160 пикселей, объявление может отображаться некорректно. Не задавайте фиксированную высоту.
Рекомендуемый диапазон ширины для элемента gmp-advanced-place-details-compact в горизонтальной ориентации – 180–500 пикселей. Если ширина меньше 160 пикселей, то объявление может показываться некорректно. Если ширина меньше 350 пикселей, значок не показывается.
Не задавайте фиксированную высоту.
Элемент gmp-advanced-place-details-compact также поддерживает различные пользовательские свойства CSS для настройки цветов и шрифтов. Подробнее о собственных стилях Places UI Kit…
Обратите внимание, что если элемент Advanced Place Details Compact добавляется в информационное окно, то собственный стиль нужно применять непосредственно к элементу gmp-advanced-place-details-compact. Это связано с тем, что информационное окно является частью теневой модели DOM карты, поэтому внешние стили CSS не будут применяться.
gmp-advanced-place-details-compact { --gmp-color-surface: #202124; --gmp-color-on-surface: #ffffff; --gmp-color-on-surface-variant: #9aa0a6; --gmp-color-primary: #8ab4f8; --gmp-font-family: "Roboto", sans-serif; }
Полный пример кода
TypeScript
// Use querySelector to select elements for interaction. const map = document.querySelector<google.maps.MapElement>('gmp-map')!; const placeDetails = document.querySelector< HTMLElement & { place?: google.maps.places.Place } >('gmp-advanced-place-details-compact')!; const placeDetailsRequest = document.querySelector<HTMLElement>( 'gmp-place-details-place-request' )!; const marker = document.querySelector<google.maps.marker.AdvancedMarkerElement>( 'gmp-advanced-marker' )!; async function init(): Promise<void> { // Request needed libraries. void Promise.all([ google.maps.importLibrary('marker'), google.maps.importLibrary('places'), ]); const { InfoWindow } = await google.maps.importLibrary('maps'); await window.customElements.whenDefined('gmp-map'); // Set the inner map options. map.innerMap.setOptions({ mapTypeControl: false, streetViewControl: false, }); await window.customElements.whenDefined('gmp-advanced-marker'); marker.collisionBehavior = 'REQUIRED_AND_HIDES_OPTIONAL'; const infoWindow = new InfoWindow(); infoWindow.addListener('close', () => { marker.position = null; }); const showInfoWindow = () => { if (infoWindow.isOpen) return; infoWindow.setContent(placeDetails); infoWindow.open({ anchor: marker }); }; placeDetails.addEventListener('gmp-load', () => { // For the initial load case, with no user click, we fall back to the place's location, and ensure the map has a center set and the InfoWindow is show. // (The clicked POI LatLng will be a more natural marker position, when available.) if (!map.center && placeDetails.place?.location) { map.center = marker.position = placeDetails.place.location; showInfoWindow(); } }); // Add an event listener to handle clicks. map.innerMap.addListener( 'click', (event: google.maps.MapMouseEvent | google.maps.IconMouseEvent) => { event.stop(); if ('placeId' in event && event.placeId) { // When the user clicks a POI. marker.position = event.latLng; placeDetailsRequest.setAttribute( 'place', `places/${event.placeId}` ); showInfoWindow(); } else { // When the user clicks the map (not on a POI). marker.position = null; placeDetailsRequest.removeAttribute('place'); console.log('No place was selected.'); } } ); } void init();
JavaScript
// Use querySelector to select elements for interaction. const map = document.querySelector('gmp-map'); const placeDetails = document.querySelector( 'gmp-advanced-place-details-compact' ); const placeDetailsRequest = document.querySelector( 'gmp-place-details-place-request' ); const marker = document.querySelector('gmp-advanced-marker'); async function init() { // Request needed libraries. void Promise.all([ google.maps.importLibrary('marker'), google.maps.importLibrary('places'), ]); const { InfoWindow } = await google.maps.importLibrary('maps'); await window.customElements.whenDefined('gmp-map'); // Set the inner map options. map.innerMap.setOptions({ mapTypeControl: false, streetViewControl: false, }); await window.customElements.whenDefined('gmp-advanced-marker'); marker.collisionBehavior = 'REQUIRED_AND_HIDES_OPTIONAL'; const infoWindow = new InfoWindow(); infoWindow.addListener('close', () => { marker.position = null; }); const showInfoWindow = () => { if (infoWindow.isOpen) return; infoWindow.setContent(placeDetails); infoWindow.open({ anchor: marker }); }; placeDetails.addEventListener('gmp-load', () => { // For the initial load case, with no user click, we fall back to the place's location, and ensure the map has a center set and the InfoWindow is show. // (The clicked POI LatLng will be a more natural marker position, when available.) if (!map.center && placeDetails.place?.location) { map.center = marker.position = placeDetails.place.location; showInfoWindow(); } }); // Add an event listener to handle clicks. map.innerMap.addListener('click', (event) => { event.stop(); if ('placeId' in event && event.placeId) { // When the user clicks a POI. marker.position = event.latLng; placeDetailsRequest.setAttribute( 'place', `places/${event.placeId}` ); showInfoWindow(); } else { // When the user clicks the map (not on a POI). marker.position = null; placeDetailsRequest.removeAttribute('place'); console.log('No place was selected.'); } }); } void init();
CSS
/* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } .container { display: flex; height: 100vh; width: 100%; } gmp-map { flex-grow: 1; }
HTML
<!doctype html>
<html>
<head>
<title>Place Details Compact with Google Maps</title>
<meta charset="utf-8" />
<link rel="stylesheet" type="text/css" href="style.css" />
<script type="module" src="./index.js"></script>
<script>
// prettier-ignore
(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
key: "GOOGLE_MAPS_API_KEY",
v: "beta"
});
</script>
</head>
<body>
<div class="container">
<!-- map-id is required to use Advanced Markers. See https://developers.google.com/maps/documentation/javascript/map-ids/mapid-over. -->
<gmp-map zoom="17" map-id="DEMO_MAP_ID">
<gmp-advanced-marker></gmp-advanced-marker>
</gmp-map>
</div>
<!--
The gmp-advanced-place-details-compact element is styled inline because it is
conditionally rendered and moved into the info window, which is
part of the map's shadow DOM.
-->
<gmp-advanced-place-details-compact
orientation="horizontal"
truncation-preferred
style="
width: 400px;
padding: 0;
margin: 0;
border: none;
background-color: transparent;
color-scheme: light;
">
<gmp-place-details-place-request
place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
<gmp-place-name></gmp-place-name>
<gmp-place-media lightbox-preferred></gmp-place-media>
<gmp-place-rating></gmp-place-rating>
<gmp-place-type></gmp-place-type>
<gmp-place-price></gmp-place-price>
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>
<gmp-place-open-now-status></gmp-place-open-now-status>
<gmp-place-attribution
light-scheme-color="gray"
dark-scheme-color="white"></gmp-place-attribution>
</gmp-advanced-place-details-compact>
</body>
</html>Расширенные функции
Как настроить командные кнопки
Добавьте кнопки действий в качестве дочерних элементов компонента Advanced Place Details. Используйте <gmp-place-link> для стандартных навигационных ссылок и явно указывайте атрибут action. Атрибут slot указывать необязательно.
Допустимые стандартные действия: open-website, open-directions, open-map и call.
Если атрибут slot не указан, по умолчанию используется значение action-main.
<gmp-advanced-place-details-compact orientation="vertical" truncation-preferred> <gmp-place-details-place-request place="places/ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request> <!-- Other content items --> <gmp-place-link action="open-website" target="_blank"></gmp-place-link> <gmp-place-link action="open-directions" slot="action-corner"></gmp-place-link> </gmp-advanced-place-details-compact>
Требования к визуальному указанию авторства
Важно! Вы должны четко сообщить конечным пользователям, что при нажатии на командную кнопку настраиваемого действия их данные будут переданы третьей стороне, не связанной с Google. Подробнее о требованиях по указанию авторства…
Не указывайте название места.
Чтобы убрать название места, исключите элемент <gmp-place-name> из пользовательского контента.
<gmp-advanced-place-details> <gmp-place-details-place-request place="places/ChIJT7FdmYiAhYAROFOvrIxRJDU"></gmp-place-details-place-request> <!-- Exclude <gmp-place-name> to hide the place name --> <gmp-place-rating></gmp-place-rating> <gmp-place-address></gmp-place-address> </gmp-advanced-place-details>
Фильтровать отзывы и медиаконтент
В этом примере кода показаны только медиафайлы и отзывы, в которых упоминается кофе.
<gmp-advanced-place-details> <gmp-place-details-place-request place="places/ChIJT7FdmYiAhYAROFOvrIxRJDU"></gmp-place-details-place-request> <gmp-place-media query="coffee"></gmp-place-media> <gmp-place-reviews query="coffee" rank-preference="newest"></gmp-place-reviews> </gmp-advanced-place-details>
Вы также можете использовать JavaScript, чтобы получить общее количество элементов, соответствующих заданному поисковому запросу, прочитав свойства searchMediaCount и searchReviewsCount. Прежде чем обращаться к этим свойствам, необходимо дождаться события gmp-load.
const detailsElement = document.querySelector('gmp-advanced-place-details'); const mediaElement = detailsElement.querySelector('gmp-place-media'); mediaElement.addEventListener('gmp-load', (e) => { console.log('Total matching photos: ', e.target.searchMediaCount); }); const reviewsElement = detailsElement.querySelector('gmp-place-reviews'); reviewsElement.addEventListener('gmp-load', (e) => { console.log('Total matching reviews: ', e.target.searchReviewsCount); });