В этом документе перечислены требования, которые являются специфическими для всех приложений, разработанных с помощью API Places (New), включая службу Autocomplete (New), которая является частью этого API. Более общую информацию для разработчиков Google Maps можно найти в Условиях обслуживания платформы Google Maps .
Предоставьте условия использования и политику конфиденциальности
Если вы разрабатываете приложение API Places, вы должны предоставить Условия использования и Политику конфиденциальности вместе с вашим приложением, которые соответствуют рекомендациям, изложенным в вашем Соглашении с Google:
- Условия использования и Политика конфиденциальности должны быть общедоступны.
- В Условиях использования вашего приложения вы должны прямо указать, что при использовании вашего приложения пользователи обязуются соблюдать Условия обслуживания Google .
- Вы должны уведомить пользователей в своей Политике конфиденциальности о том, что вы используете API Google Карт, и включить в нее ссылку на Политику конфиденциальности Google .
Рекомендуемое место для размещения ваших Условий использования и Политики конфиденциальности зависит от платформы вашего приложения.
Мобильные приложения
При разработке мобильного приложения рекомендуется указать ссылку на Условия использования и Политику конфиденциальности на странице загрузки вашего приложения в соответствующем магазине приложений и в меню настроек приложения.
Веб-приложения
При разработке веб-приложения рекомендуется разместить ссылку на Условия использования и Политику конфиденциальности в нижнем колонтитуле вашего веб-сайта.
Предварительная загрузка, кэширование или хранение контента
Приложения, использующие API Places, связаны условиями вашего Соглашения с Google. В соответствии с условиями вашего Соглашения вы не должны предварительно загружать, индексировать, хранить или кэшировать любой Контент, за исключением ограниченных условий, указанных в условиях.
Обратите внимание, что идентификатор места , используемый для уникальной идентификации места, освобожден от ограничений кэширования . Таким образом, вы можете хранить значения идентификатора места неограниченное время. Идентификатор места возвращается в поле place_id в ответах API. Узнайте, как сохранять, обновлять и управлять идентификаторами мест, в руководстве по идентификаторам мест .
Отображение результатов API Places
Вы можете отображать результаты API мест на карте Google Maps или без карты. Если вы хотите отображать результаты API мест на карте, то эти результаты должны быть отображены на карте Google Maps. Запрещается использовать данные API мест на карте, которая не является картой Google.
Отображение логотипа Google и указание авторства
Если ваше приложение отображает данные на карте Google, то логотип Google будет включен и не может быть изменен. Приложения, отображающие данные Google на том же экране, что и карта Google, не обязаны предоставлять дополнительную ссылку на Google.
Если ваше приложение отображает данные на странице или в представлении, которое также не отображает карту Google, вы должны отобразить логотип Google с этими данными. Например, если ваше приложение отображает данные Google на одной вкладке, а карту Google с этими данными на другой вкладке, на первой вкладке должен отображаться логотип Google. Если ваше приложение использует поля поиска с автозаполнением или без него, логотип должен отображаться в строке.
Логотип Google должен быть размещен в левом нижнем углу карты, а информация об авторстве — в правом нижнем углу, и то и другое должно быть представлено на карте как единое целое, а не под картой или другим местом в приложении. Следующий пример карты показывает логотип Google в левом нижнем углу карты, а информацию об авторстве — в правом нижнем углу.
| Для использования на светлом фоне | Для использования на темном фоне |
|---|---|
 |  |
Следующий zip-файл содержит логотип Google в правильных размерах для приложений на рабочем столе, Android и iOS. Вы не можете изменять размер или модифицировать эти логотипы каким-либо образом.
Загрузить: google_logo.zip
Не изменяйте атрибуцию. Не удаляйте, не скрывайте и не обрезайте информацию об атрибуции. Вы не можете использовать логотипы Google в строке (например, «Эти карты из [Google_logo]»).
Сохраняйте атрибуцию близко. При использовании скриншотов изображений Google вне прямых вставок включите стандартную атрибуцию, как она отображается на изображении. При необходимости вы можете настроить стиль и размещение текста атрибуции, при условии, что текст находится в непосредственной близости от контента и будет понятен для обычного зрителя или читателя. Вы не можете перемещать атрибуцию далеко от контента, например, в конец вашей книги, в титры ваших файлов или шоу или в нижний колонтитул вашего веб-сайта.
Включайте сторонних поставщиков данных. Некоторые данные и изображения в наших картографических продуктах поступают от поставщиков, отличных от Google. При использовании таких изображений текст вашего указания авторства должен содержать название «Google» и соответствующих поставщиков данных, например «Картографические данные: Google, Maxar Technologies». Если в изображениях указаны сторонние поставщики данных, указание только «Google» или логотипа Google не является надлежащим указанием авторства.
Если вы используете платформу Google Карт на устройстве, где отображение атрибуции нецелесообразно, свяжитесь с отделом продаж Google, чтобы обсудить лицензии, подходящие для вашего варианта использования.
Другие требования к атрибуции
Следуйте этим инструкциям, чтобы получить сторонние атрибуции и отобразить их в своем приложении.
Получить атрибуции из места
Если ваше приложение отображает информацию, полученную путем вызова Place Details с идентификатором места, приложение также должно отображать сторонние атрибуции для полученных сведений о месте.
Атрибуции в объекте Place ответа представлены объектом Attribution . Чтобы добавить Attribution в ответ, включите places.attributions (поиск поблизости и текстовый поиск) или attributions (сведения о месте) в маску поля запроса.
Поля объекта Attribution представляют собой строки, содержащие provider и providerUri атрибуции, или пустую строку, если нет атрибуций для отображения.
Отображение атрибуции для фотографии
Если ваше приложение отображает фотографии, вы должны указать автора каждой фотографии, на которой они размещены.
Подробная информация о фотографии в объекте Place ответа содержится в массиве photos . Чтобы добавить массив photos в ответ, включите places.photos (поиск поблизости и текстовый поиск) или photos (сведения о месте) в маску поля запроса.
Каждый элемент массива photos является экземпляром Photo , который содержит массив authorAttributions типа AuthorAttribution .
Поля объекта AuthorAttribution представляют собой строки, содержащие displayName , uri и photoUri атрибуции или пустую строку, если нет атрибуций для отображения.
Показать обзор
Объект Place в ответе может содержать до пяти отзывов. Вы можете опционально отображать эти отзывы в своем приложении.
При отображении отзывов, предоставленных пользователями Google, вы должны поместить имя автора в непосредственной близости. Если оно доступно в поле авторства объекта Review , мы рекомендуем вам также включить фотографию автора и ссылку на его профиль. На следующем изображении показан пример отзыва о парке:
Google также рекомендует вам показывать конечному пользователю, как сортируются отзывы.
Каждый отзыв в объекте Place ответа представлен объектом Review . Чтобы добавить объект Review в ответ, включите places.reviews (поиск поблизости и текстовый поиск) или reviews (сведения о месте) в маску поля запроса.
Поля объекта Review содержат информацию об авторстве или остаются пустыми, если информация об авторстве отсутствует.
Результаты поиска атрибуции
В Европе при использовании чистого рейтинга Google поисковые продукты должны иметь пояснительный текст, расположенный не более чем в 1 клике, в котором описываются основные факторы и вес основных факторов, определяющих рейтинг результатов поиска. Пояснительный текст:
Заголовок: Об этих результатах
Текст: Когда вы ищете компании или места рядом с местоположением, Google Maps покажет вам локальные результаты. Несколько факторов — в первую очередь релевантность, расстояние и известность — объединяются, чтобы помочь найти лучшие результаты для вашего поиска.
Кнопка 1: Узнать больше
Текст «Узнать больше» должен ссылаться на статью Справочного центра .
Кнопка 2: ОК
Резюме на основе искусственного интеллекта
При отображении в приложении сводок, созданных с помощью ИИ, включая сводки по месту, области и отзывам, вам необходимо выполнить следующие действия:
- Отобразите необходимые ссылки на источники, отчеты и справочные ссылки, как определено ниже.
- Конечные пользователи должны иметь возможность прочитать полный текст резюме, предоставленный Google Maps.
Отображение текста раскрытия информации с помощью ИИ
При отображении сводки любого типа на основе ИИ всегда включайте локализованный текст раскрытия (указанный в поле disclosureText тела ответа) сразу под сводкой. Никогда не изменяйте и не дополняйте текст раскрытия, предоставленный API.
Дополнительные требования к месту и площади
Сводки по местам и областям, отображаемые в вашем приложении, должны сопровождаться следующим текстом и обязательными ссылками:
| Текст | Требование |
|---|---|
| Об этом резюме | Воспользуйтесь следующей ссылкой для получения информации о том, как Google получает и использует информацию в местных листингах: https://support.google.com/local-listings/answer/9851099 . |
| Резюме отчета | Используйте ссылку, содержащуюся в поле Примечание: сводки на основе ИИ, предоставляемые через API Places (новый), подчиняются политикам Google в отношении контента и продуктов, где бы вы ни находились. Вы обязаны уведомить своих конечных пользователей, что если они хотят сообщить о контенте, который должен быть удален из служб Google в соответствии с действующим законодательством, они должны сообщить об этом, используя предоставленный URL-адрес флага контента ( |
Требования к резюме обзора
Обзоры резюме, отображаемые в вашем приложении, должны сопровождаться заголовком с текстом «Обзор резюме». Кроме того, вы должны использовать следующий текст и обязательные ссылки:
| Текст | Требование |
|---|---|
| Об этом резюме | Воспользуйтесь следующей ссылкой для раздела «Как Google получает и использует информацию в местных листингах»: https://support.google.com/local-listings/answer/9851099 |
| Резюме отчета | Используйте ссылку, содержащуюся в поле Примечание: сводки на основе ИИ, предоставляемые через API Places (новый), подчиняются политикам Google в отношении контента и продуктов, где бы вы ни находились. Вы обязаны уведомить своих конечных пользователей, что если они хотят сообщить о контенте, который должен быть удален из служб Google в соответствии с действующим законодательством, они должны сообщить об этом, используя предоставленный URL-адрес флага контента ( |
| Смотреть отзывы | Используйте ссылку, содержащуюся в поле googleMapsLinks.reviewsUri ответа. |
Руководство по отображению вариантов использования в автомобильной промышленности
Для безопасности водителя Google рекомендует отображать сводки на базе ИИ в режиме парковки для автомобильных впечатлений. При отображении сводок в режиме вождения информация на экране должна быть простой, ясной и краткой, чтобы гарантировать, что внимание водителя быстро вернется к дороге:
- Не более 3 строк
- 120 символов или 24 слова или меньше
- Минимальный размер лицевой стороны 24dp
Особенно в автомобильном контексте разработчик несет ответственность за создание сводок на основе ИИ безопасными способами, соответствующими всем местным законам и правилам.
Руководство по стилю для атрибуции Google
Ниже приведены рекомендации по стилю указания авторства Google в CSS и HTML на случай, если вы не можете использовать загружаемый логотип Google.
Очистить место
Количество свободного пространства вокруг значка блокировки должно быть равно или превышать высоту буквы «G» в Google.
Расстояние между текстом с указанием авторства и логотипом Google должно составлять половину ширины буквы «G».
Разборчивость
Подпись всегда должна быть четкой, разборчивой и отображаться в правильной цветовой вариации для данного фона. Всегда будьте уверены, что обеспечиваете достаточный контраст для выбранной вами вариации логотипа.
Цвет
Используйте текст Google Material Gray 700 на белом или светлом фоне с диапазоном оттенков черного от 0% до 40%.
#5f6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
На темном фоне, а также поверх фотографий или неперегруженных узоров используйте белый текст для подписи автора и указания источника.
#ffffff RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Шрифт
Используйте шрифт Roboto .
Пример CSS-кода
Следующий CSS-код, примененный к тексту «Google», отобразит «Google» с соответствующим шрифтом, цветом и интервалом на белом или светлом фоне.
font-family: Roboto; font-style: normal; font-weight: 500; font-size: 16px; line-height: 16px; padding: 16px; letter-spacing: 0.0575em; /* 0.69px */ color: #5f6368;
В этом документе перечислены требования, которые являются специфическими для всех приложений, разработанных с помощью API Places (New), включая службу Autocomplete (New), которая является частью этого API. Более общую информацию для разработчиков Google Maps можно найти в Условиях обслуживания платформы Google Maps .
Предоставьте условия использования и политику конфиденциальности
Если вы разрабатываете приложение API Places, вы должны предоставить Условия использования и Политику конфиденциальности вместе с вашим приложением, которые соответствуют рекомендациям, изложенным в вашем Соглашении с Google:
- Условия использования и Политика конфиденциальности должны быть общедоступны.
- В Условиях использования вашего приложения вы должны прямо указать, что при использовании вашего приложения пользователи обязуются соблюдать Условия обслуживания Google .
- Вы должны уведомить пользователей в своей Политике конфиденциальности о том, что вы используете API Google Карт, и включить в нее ссылку на Политику конфиденциальности Google .
Рекомендуемое место для размещения ваших Условий использования и Политики конфиденциальности зависит от платформы вашего приложения.
Мобильные приложения
При разработке мобильного приложения рекомендуется указать ссылку на Условия использования и Политику конфиденциальности на странице загрузки вашего приложения в соответствующем магазине приложений и в меню настроек приложения.
Веб-приложения
При разработке веб-приложения рекомендуется разместить ссылку на Условия использования и Политику конфиденциальности в нижнем колонтитуле вашего веб-сайта.
Предварительная загрузка, кэширование или хранение контента
Приложения, использующие API Places, связаны условиями вашего Соглашения с Google. В соответствии с условиями вашего Соглашения вы не должны предварительно загружать, индексировать, хранить или кэшировать любой Контент, за исключением ограниченных условий, указанных в условиях.
Обратите внимание, что идентификатор места , используемый для уникальной идентификации места, освобожден от ограничений кэширования . Таким образом, вы можете хранить значения идентификатора места неограниченное время. Идентификатор места возвращается в поле place_id в ответах API. Узнайте, как сохранять, обновлять и управлять идентификаторами мест, в руководстве по идентификаторам мест .
Отображение результатов API Places
Вы можете отображать результаты API мест на карте Google Maps или без карты. Если вы хотите отображать результаты API мест на карте, то эти результаты должны быть отображены на карте Google Maps. Запрещается использовать данные API мест на карте, которая не является картой Google.
Отображение логотипа Google и указание авторства
Если ваше приложение отображает данные на карте Google, то логотип Google будет включен и не может быть изменен. Приложения, отображающие данные Google на том же экране, что и карта Google, не обязаны предоставлять дополнительную ссылку на Google.
Если ваше приложение отображает данные на странице или в представлении, которое также не отображает карту Google, вы должны отобразить логотип Google с этими данными. Например, если ваше приложение отображает данные Google на одной вкладке, а карту Google с этими данными на другой вкладке, на первой вкладке должен отображаться логотип Google. Если ваше приложение использует поля поиска с автозаполнением или без него, логотип должен отображаться в строке.
Логотип Google должен быть размещен в левом нижнем углу карты, а информация об авторстве — в правом нижнем углу, и то и другое должно быть представлено на карте как единое целое, а не под картой или другим местом в приложении. Следующий пример карты показывает логотип Google в левом нижнем углу карты, а информацию об авторстве — в правом нижнем углу.
| Для использования на светлом фоне | Для использования на темном фоне |
|---|---|
| |
Следующий zip-файл содержит логотип Google в правильных размерах для приложений на рабочем столе, Android и iOS. Вы не можете изменять размер или модифицировать эти логотипы каким-либо образом.
Загрузить: google_logo.zip
Не изменяйте атрибуцию. Не удаляйте, не скрывайте и не обрезайте информацию об атрибуции. Вы не можете использовать логотипы Google в строке (например, «Эти карты из [Google_logo]»).
Сохраняйте атрибуцию близко. При использовании скриншотов изображений Google вне прямых вставок включите стандартную атрибуцию, как она отображается на изображении. При необходимости вы можете настроить стиль и размещение текста атрибуции, при условии, что текст находится в непосредственной близости от контента и будет понятен для обычного зрителя или читателя. Вы не можете перемещать атрибуцию далеко от контента, например, в конец вашей книги, в титры ваших файлов или шоу или в нижний колонтитул вашего веб-сайта.
Включайте сторонних поставщиков данных. Некоторые данные и изображения в наших картографических продуктах поступают от поставщиков, отличных от Google. При использовании таких изображений текст вашего указания авторства должен содержать название «Google» и соответствующих поставщиков данных, например «Картографические данные: Google, Maxar Technologies». Если в изображениях указаны сторонние поставщики данных, указание только «Google» или логотипа Google не является надлежащим указанием авторства.
Если вы используете платформу Google Карт на устройстве, где отображение атрибуции нецелесообразно, свяжитесь с отделом продаж Google, чтобы обсудить лицензии, подходящие для вашего варианта использования.
Другие требования к атрибуции
Следуйте этим инструкциям, чтобы получить сторонние атрибуции и отобразить их в своем приложении.
Получить атрибуции из места
Если ваше приложение отображает информацию, полученную путем вызова Place Details с идентификатором места, приложение также должно отображать сторонние атрибуции для полученных сведений о месте.
Атрибуции в объекте Place ответа представлены объектом Attribution . Чтобы добавить Attribution в ответ, включите places.attributions (поиск поблизости и текстовый поиск) или attributions (сведения о месте) в маску поля запроса.
Поля объекта Attribution представляют собой строки, содержащие provider и providerUri атрибуции, или пустую строку, если нет атрибуций для отображения.
Отображение атрибуции для фотографии
Если ваше приложение отображает фотографии, вы должны указать автора каждой фотографии, на которой они размещены.
Подробная информация о фотографии в объекте Place ответа содержится в массиве photos . Чтобы добавить массив photos в ответ, включите places.photos (поиск поблизости и текстовый поиск) или photos (сведения о месте) в маску поля запроса.
Каждый элемент массива photos является экземпляром Photo , который содержит массив authorAttributions типа AuthorAttribution .
Поля объекта AuthorAttribution представляют собой строки, содержащие displayName , uri и photoUri атрибуции или пустую строку, если нет атрибуций для отображения.
Показать обзор
Объект Place в ответе может содержать до пяти отзывов. Вы можете опционально отображать эти отзывы в своем приложении.
При отображении отзывов, предоставленных пользователями Google, вы должны поместить имя автора в непосредственной близости. Если оно доступно в поле авторства объекта Review , мы рекомендуем вам также включить фотографию автора и ссылку на его профиль. На следующем изображении показан пример отзыва о парке:
Google также рекомендует вам показывать конечному пользователю, как сортируются отзывы.
Каждый отзыв в объекте Place ответа представлен объектом Review . Чтобы добавить объект Review в ответ, включите places.reviews (поиск поблизости и текстовый поиск) или reviews (сведения о месте) в маску поля запроса.
Поля объекта Review содержат информацию об авторстве или остаются пустыми, если информация об авторстве отсутствует.
Результаты поиска атрибуции
В Европе при использовании чистого рейтинга Google поисковые продукты должны иметь пояснительный текст, расположенный не более чем в 1 клике, в котором описываются основные факторы и вес основных факторов, определяющих рейтинг результатов поиска. Пояснительный текст:
Заголовок: Об этих результатах
Текст: Когда вы ищете компании или места рядом с местоположением, Google Maps покажет вам локальные результаты. Несколько факторов — в первую очередь релевантность, расстояние и известность — объединяются, чтобы помочь найти лучшие результаты для вашего поиска.
Кнопка 1: Узнать больше
Текст «Узнать больше» должен ссылаться на статью Справочного центра .
Кнопка 2: ОК
Резюме на основе искусственного интеллекта
При отображении в приложении сводок, созданных с помощью ИИ, включая сводки по месту, области и отзывам, вам необходимо выполнить следующие действия:
- Отобразите необходимые ссылки на источники, отчеты и справочные ссылки, как определено ниже.
- Конечные пользователи должны иметь возможность прочитать полный текст резюме, предоставленный Google Maps.
Отображение текста раскрытия информации с помощью ИИ
При отображении сводки любого типа на основе ИИ всегда включайте локализованный текст раскрытия (указанный в поле disclosureText тела ответа) сразу под сводкой. Никогда не изменяйте и не дополняйте текст раскрытия, предоставленный API.
Дополнительные требования к месту и площади
Сводки по местам и областям, отображаемые в вашем приложении, должны сопровождаться следующим текстом и обязательными ссылками:
| Текст | Требование |
|---|---|
| Об этом резюме | Воспользуйтесь следующей ссылкой для получения информации о том, как Google получает и использует информацию в местных листингах: https://support.google.com/local-listings/answer/9851099 . |
| Резюме отчета | Используйте ссылку, содержащуюся в поле Примечание: сводки на основе ИИ, предоставляемые через API Places (новый), подчиняются политикам Google в отношении контента и продуктов, где бы вы ни находились. Вы обязаны уведомить своих конечных пользователей, что если они хотят сообщить о контенте, который должен быть удален из служб Google в соответствии с действующим законодательством, они должны сообщить об этом, используя предоставленный URL-адрес флага контента ( |
Требования к резюме обзора
Обзоры резюме, отображаемые в вашем приложении, должны сопровождаться заголовком с текстом «Обзор резюме». Кроме того, вы должны использовать следующий текст и обязательные ссылки:
| Текст | Требование |
|---|---|
| Об этом резюме | Воспользуйтесь следующей ссылкой для раздела «Как Google получает и использует информацию в местных листингах»: https://support.google.com/local-listings/answer/9851099 |
| Резюме отчета | Используйте ссылку, содержащуюся в поле Примечание: сводки на основе ИИ, предоставляемые через API Places (новый), подчиняются политикам Google в отношении контента и продуктов, где бы вы ни находились. Вы обязаны уведомить своих конечных пользователей, что если они хотят сообщить о контенте, который должен быть удален из служб Google в соответствии с действующим законодательством, они должны сообщить об этом, используя предоставленный URL-адрес флага контента ( |
| Смотреть отзывы | Используйте ссылку, содержащуюся в поле googleMapsLinks.reviewsUri ответа. |
Руководство по отображению вариантов использования в автомобильной промышленности
Для безопасности водителя Google рекомендует отображать сводки на базе ИИ в режиме парковки для автомобильных впечатлений. При отображении сводок в режиме вождения информация на экране должна быть простой, ясной и краткой, чтобы гарантировать, что внимание водителя быстро вернется к дороге:
- Не более 3 строк
- 120 символов или 24 слова или меньше
- Минимальный размер лицевой стороны 24dp
Особенно в автомобильном контексте разработчик несет ответственность за создание сводок на основе ИИ безопасными способами, соответствующими всем местным законам и правилам.
Руководство по стилю для атрибуции Google
Ниже приведены рекомендации по стилю указания авторства Google в CSS и HTML на случай, если вы не можете использовать загружаемый логотип Google.
Очистить место
Количество свободного пространства вокруг значка блокировки должно быть равно или превышать высоту буквы «G» в Google.
Расстояние между текстом с указанием авторства и логотипом Google должно составлять половину ширины буквы «G».
Разборчивость
Подпись всегда должна быть четкой, разборчивой и отображаться в правильной цветовой вариации для данного фона. Всегда будьте уверены, что обеспечиваете достаточный контраст для выбранной вами вариации логотипа.
Цвет
Используйте текст Google Material Gray 700 на белом или светлом фоне с диапазоном оттенков черного от 0% до 40%.
#5f6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
На темном фоне, а также поверх фотографий или неперегруженных узоров используйте белый текст для подписи автора и указания источника.
#ffffff RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Шрифт
Используйте шрифт Roboto .
Пример CSS-кода
Следующий CSS-код, примененный к тексту «Google», отобразит «Google» с соответствующим шрифтом, цветом и интервалом на белом или светлом фоне.
font-family: Roboto; font-style: normal; font-weight: 500; font-size: 16px; line-height: 16px; padding: 16px; letter-spacing: 0.0575em; /* 0.69px */ color: #5f6368;