Элементы информации о местах

Выберите платформу: Android iOS JavaScript

Выберите подходящий компонент:

• Элемент "Сведения о месте" позволяет показывать информацию о выбранном месте, например часы работы, сайт и отзывы. Оплата за него взимается в соответствии с уровнем Essentials.
• Расширенный элемент "Сведения об адресе" (предварительная версия) дополняет элемент "Сведения об адресе" и позволяет настраивать кнопки действий, а также применять параметры поиска и фильтрации к отзывам и медиафайлам. Она оплачивается по тарифу Pro.

Элемент "Сведения о месте" и компактный элемент "Сведения о месте" – это HTML-элементы, которые позволяют отображать информацию о месте:

• Тег PlaceDetailsElement поддерживает все визуализируемые данные о местах и может содержать несколько фотографий.
• PlaceDetailsCompactElement занимает мало места и содержит краткую информацию о месте, в том числе название, адрес и рейтинг. Также может быть добавлена одна фотография.

С помощью инструмента настройки можно посмотреть, как разные наборы свойств влияют на внешний вид элемента "Информация о месте", и получить доступ к коду на HTML/CSS, Kotlin/XML и Swift.

Элемент "Информация о месте"

Нажмите на маркер на карте, чтобы посмотреть сведения о месте в элементе Place Details.

PlaceDetailsElement поддерживает широкий спектр элементов контента, включая полное расписание работы, сайт, номер телефона, сводку на основе ИИ (с возможностью переключения на редакционную сводку), основные сведения о типе, отзывы, сводку отзывов на основе ИИ, код и списки функций.

Чтобы показывать информацию о местах на карте, добавьте элемент gmp-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-place-details>
      <gmp-place-details-place-request place="ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
      <gmp-place-all-content></gmp-place-all-content>
    </gmp-place-details>
  </div>
  <gmp-advanced-marker></gmp-advanced-marker>
</gmp-map>

Совет. Идентификатор места можно найти с помощью инструмента поиска идентификаторов мест.

Как настроить контент

Вы можете управлять контентом, который отображается в элементе gmp-place-details, с помощью вложенного элемента gmp-place-content-config, чтобы выбрать и настроить сведения о месте, как показано в следующем примере:

        <gmp-place-details>
            <gmp-place-details-place-request
                place="ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
            <gmp-place-content-config>
                <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-content-config>
        </gmp-place-details>

Элемент gmp-place-content-config содержит несколько дочерних элементов, каждый из которых выбирает определенную информацию о месте для показа:gmp-place-address – адрес, gmp-place-price – уровень цен и т. д. Элементы gmp-place-summary и gmp-place-review-summary содержат сгенерированные ИИ краткие описания места и отзывов о нем соответственно. Порядок дочерних элементов не имеет значения, поскольку выбранные сведения всегда отображаются в заданном порядке.

Некоторые из этих элементов можно дополнительно настроить с помощью атрибутов, относящихся к контенту:

• Элемент gmp-place-media используется для показа одной фотографии и включает атрибут lightbox-preferred, который открывает фотографию в лайтбоксе при нажатии. По умолчанию формат Lightbox отключен.
• Элемент gmp-place-attribution используется для показа источника фотографии. Атрибуты light-scheme-color и dark-scheme-color используются для настройки цвета текста атрибуции в светлом и темном режимах.

Дополнительную информацию обо всех поддерживаемых элементах контента можно найти в справочной документации по PlaceContentConfigElement.

Для простоты элемент gmp-place-content-config можно заменить на gmp-place-all-content , чтобы показать все сведения, доступные в элементе "Дополнительные сведения о месте", или на gmp-place-standard-content , чтобы отобразить стандартную конфигурацию.

Как настроить внешний вид

Рекомендуемый диапазон ширины для элемента gmp-place-details – 250–400 пикселей. Ширина менее 250 пикселей может отображаться некорректно. Задайте высоту в соответствии с требованиями вашего приложения. Элемент "Информация о месте" разработан таким образом, чтобы при необходимости прокручиваться в отведенном пространстве.

Элемент gmp-place-details также поддерживает различные пользовательские свойства CSS, позволяющие настраивать цвета и шрифты элемента. Подробнее о настройке стиля Places UI Kit…

Важно! При внесении визуальных изменений необходимо соблюдать требования к атрибуции.

Посмотреть полный пример кода

JavaScript

// Use querySelector to select elements for interaction.
const map = document.querySelector('gmp-map');
const placeDetails = document.querySelector('gmp-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.place = 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();
index.js

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;
}
style.css

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"
            });
        </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-place-details>
                    <gmp-place-details-place-request
                        place="ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
                    <gmp-place-content-config>
                        <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-content-config>
                </gmp-place-details>
            </div>
        </div>
    </body>
</html>
index.html

Элемент "Компактная информация о месте"

Нажмите на маркер на карте, чтобы посмотреть сведения о месте в компактном элементе "Сведения о месте".

PlaceDetailsCompactElement позволяет показывать информацию о выбранном месте, занимая минимум места. Это может быть полезно в информационном окне, выделяющем место на карте, в социальных сетях, например при отправке местоположения в чате, в качестве предложения для выбора текущего местоположения или в статье, чтобы ссылаться на место на Google Картах. PlaceDetailsCompactElement может содержать отображаемое название, адрес, рейтинг, тип, цену, значок доступности, статус "Открыто" и одну фотографию. Его можно разместить горизонтально или вертикально в зависимости от значения атрибута "ориентация" orientation.

В приведенном ниже фрагменте кода для параметра gmp-place-details-compact задано значение orientation, равное horizontal. Дополнительный атрибут truncation-preferred позволяет обрезать определенный контент, чтобы он помещался на одной строке. Элемент gmp-place-details-compact содержит дочерний элемент gmp-place-details-place-request, чтобы выбрать место. Это может быть объект Place, идентификатор места или название ресурса места.

  <gmp-place-details-compact orientation="horizontal" truncation-preferred>
    <gmp-place-details-place-request place="ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
    <gmp-place-all-content></gmp-place-all-content>
  </gmp-place-details-compact>

Совет. Идентификатор места можно найти с помощью инструмента поиска идентификаторов мест.

Как настроить контент

Вы можете управлять контентом, который отображается в элементе gmp-place-details-compact, с помощью вложенного элемента gmp-place-content-config, чтобы выбрать и настроить сведения о месте, как показано в следующем фрагменте кода:

<gmp-place-content-config>
    <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-place-content-config>
index.html

Сам элемент gmp-place-content-config содержит несколько дочерних элементов контента, каждый из которых выбирает определенную информацию о месте для показа. Порядок дочерних элементов не имеет значения, поскольку выбранные сведения всегда отображаются в фиксированном порядке. Некоторые из этих элементов можно дополнительно настроить с помощью атрибутов, относящихся к контенту.

Дополнительную информацию обо всех поддерживаемых элементах контента можно найти в справочной документации по PlaceContentConfigElement.

Для простоты элемент gmp-place-content-config можно заменить на gmp-place-all-content , чтобы показать все сведения, доступные в компактном элементе "Дополнительные сведения о месте", или на gmp-place-standard-content , чтобы отобразить стандартную конфигурацию.

Как настроить внешний вид

Рекомендуемый диапазон ширины для элемента gmp-place-details-compact в вертикальной ориентации – 180–300 пикселей. Ширина менее 160 пикселей может отображаться некорректно. Не задавайте фиксированную высоту.

Рекомендуемый диапазон ширины элемента gmp-place-details-compact в горизонтальной ориентации – 180–500 пикселей. Ширина менее 160 пикселей может отображаться некорректно. При ширине менее 350 пикселей значок видео не показывается. Не задавайте фиксированную высоту.

Элемент gmp-place-details-compact также поддерживает различные пользовательские свойства CSS, позволяющие настраивать цвета и шрифты элемента. Подробнее о настройке стиля Places UI Kit…

Важно! При внесении визуальных изменений необходимо соблюдать требования к атрибуции.

Обратите внимание, что если компактный элемент "Сведения о месте" добавлен в информационное окно, то пользовательские стили необходимо применять непосредственно к элементу gmp-place-details-compact. Это связано с тем, что информационное окно является частью теневого DOM карты, поэтому внешние стили CSS не будут применены.

<gmp-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="ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
index.html

Посмотреть полный пример кода

В этом примере показано, как добавить PlaceDetailsCompactElement на карту программно с помощью InfoWindow и AdvancedMarkerElement.

JavaScript

// Use querySelector to select elements for interaction.
const map = document.querySelector('gmp-map');
const placeDetails = document.querySelector('gmp-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) {
            // When the user clicks a POI.
            marker.position = event.latLng;
            placeDetailsRequest.place = event.placeId;
            showInfoWindow();
        } else {
            // When the user clicks the map (not on a POI).
            marker.position = null;
            placeDetailsRequest.place = null;
            console.log('No place was selected.');
        }
    });
}
void init();
index.js

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;
}
style.css

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"
            });
        </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-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-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="ChIJC8HakaIRkFQRiOgkgdHmqkk"></gmp-place-details-place-request>
            <gmp-place-content-config>
                <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-place-content-config>
        </gmp-place-details-compact>
    </body>
</html>
index.html