Политики API фрагментов карты

В этом документе перечислены требования к приложениям, разработанным с использованием API Map Tiles. Обратите внимание, что использование Map Tiles API регулируется вашим Соглашением с Google.

Предоставление условий использования и политики конфиденциальности

Если вы разрабатываете приложение Map Tiles API, вы должны предоставить Условия использования и Политику конфиденциальности вместе с вашим приложением, которые соответствуют рекомендациям, изложенным в вашем Соглашении с Google:

  • Условия использования и Политика конфиденциальности должны быть общедоступными.
  • В Условиях использования вашего приложения вы должны прямо указать, что, используя ваше приложение, пользователи обязаны соблюдать Условия использования Google .
  • В своей Политике конфиденциальности вы должны уведомить пользователей о том, что вы используете API Google Maps, и включить посредством ссылки Политику конфиденциальности Google .

Рекомендуемое место для размещения ваших Условий использования и Политики конфиденциальности зависит от платформы вашего приложения.

Мобильные приложения

При разработке мобильного приложения рекомендуется разместить ссылку на Условия использования и Политику конфиденциальности на странице загрузки вашего приложения в соответствующем магазине приложений и в меню настроек приложения.

Веб-приложения

При разработке веб-приложения рекомендуется предоставить ссылку на Условия использования и Политику конфиденциальности в нижнем колонтитуле вашего веб-сайта.

Предварительная загрузка, кэширование или хранение контента

Приложения, использующие Map Tiles API, подчиняются условиям вашего Соглашения с Google. В соответствии с условиями вашего Соглашения вы не имеете права предварительно загружать, индексировать, хранить или кэшировать какой-либо Контент, за исключением ограниченных условий, указанных в условиях.

В частности, приложения должны использовать Map Tiles API для визуализации карт. Вы не можете использовать Map Tiles API для любых случаев использования, не связанных с визуализацией, таких как:

  • Анализ изображений
  • Машинная интерпретация
  • Обнаружение или идентификация объекта
  • Извлечение или перепродажа геоданных
  • Автономное использование, в том числе для любого из вышеперечисленных

Ответы API Map Tiles могут включать заголовки Cache-Control , которые должны быть реализованы в соответствии с документацией протокола HTTP . Например, ваш клиент должен соблюдать значение max-age , значение stale-while-revalidate , директиву must-revalidate и private директиву, когда они передаются в ответе.

Ответы API Map Tiles также могут включать заголовок ETag , который также должен быть реализован в соответствии с документацией протокола HTTP при запросе с повторной проверкой.

Обратите внимание, что идентификатор места , используемый для уникальной идентификации места, не подпадает под ограничения кэширования . Идентификатор места возвращается в поле place_id в ответах API Map Tiles. Узнайте, как сохранять, обновлять идентификаторы мест и управлять ими, в руководстве по идентификаторам мест .

Когда вы используете API плиток карты для отображения Карт Google, вы также должны отображать логотип Google на карте и не должны каким-либо образом изменять логотип. Вам следует разместить логотип Google в левом нижнем углу карты, а информацию об авторстве — в правом углу карты. Для получения дополнительной информации ознакомьтесь с рекомендациями нашего Центра ресурсов по брендам .

Для 3D-карт, которые являются более кинематографичными, то есть, если ваши требования к экспериментальному UX-дизайну не могут легко удовлетворить эти рекомендации по размещению, вам все равно следует четко отображать логотип Google в начале, конце или обоих концах интерфейса, чтобы авторство карты понятно вашей аудитории. Вы по-прежнему обязаны соблюдать правила отображения сторонних данных, как описано ниже, на протяжении всего кинематографического опыта. Дополнительные инструкции см. в разделе «Отображение атрибутов логотипа и данных в гибридных визуализациях» ниже.

В следующем примере карты показан логотип Google в левом нижнем углу карты и атрибуция в правом нижнем углу.

Следующий ZIP-файл содержит логотип Google в размерах, подходящих для приложений для настольных компьютеров, Android и iOS. Вы не можете каким-либо образом изменять размер или модифицировать эти логотипы.

Скачать: google_logo.zip

Не изменяйте атрибуцию. Не удаляйте, не скрывайте и не вырезайте информацию об авторстве. Вы не можете использовать встроенные логотипы Google (например, «Эти карты взяты из [Google_logo]»).

Держите атрибуцию близкой. Если вы используете скриншоты изображений Google помимо прямого встраивания, включите стандартную атрибуцию, как она отображается на изображении. При необходимости вы можете настроить стиль и размещение текста указания авторства, при условии, что текст находится в непосредственной близости от контента и удобен для чтения среднестатистическому зрителю или читателю. Вы не имеете права перемещать указание авторства за пределы контента, например, в конец вашей книги, в титры ваших файлов или шоу или в нижний колонтитул вашего веб-сайта.

Включите сторонних поставщиков данных. Некоторые данные и изображения в наших картографических продуктах получены не от Google, а от других поставщиков. При использовании таких изображений в тексте вашего указания должно быть указано имя «Google» и соответствующий поставщик(и) данных, например «Картографические данные: Google, Maxar Technologies». Если в изображениях упоминаются сторонние поставщики данных, включение только слова «Google» или логотипа Google не является надлежащей атрибуцией.

Если вы используете платформу Google Maps на устройстве, где отображение авторства нецелесообразно, обратитесь в отдел продаж Google , чтобы обсудить лицензии, подходящие для вашего варианта использования.

Отображение логотипа Google с помощью сторонних средств визуализации

Когда вы используете Map Tiles API для отображения Карт Google с помощью стороннего средства визуализации, вы не должны перекрывать или закрывать логотип Google любым другим логотипом, например логотипом средства визуализации. Сохраняйте разумное буферное расстояние между логотипом Google и сторонним логотипом, чтобы они выглядели как независимые логотипы. Никакой логотип не может перекрывать или скрывать атрибуцию данных, предоставленную ответом API.

Визуализированное изображение с логотипами Google и Cesium.

Отображение атрибуции данных Google

Данные, возвращаемые из API плиток карты, требуют отображения информации об авторстве и авторских правах из соответствующих запросов метаданных или информации об области просмотра. Вы должны отобразить эту информацию в полном объеме, как указано, в соответствующем месте, обычно в правом нижнем углу отображаемого набора плиток или в представлении 3D-рендеринга. Обратите внимание, что строки атрибутов являются переменными и зависят от данных карты, запрошенных окном просмотра средства визуализации.

Если невозможно отобразить атрибуцию данных полностью из-за ограничений размера области просмотра, рассмотрите возможность добавления элемента пользовательского интерфейса, наводимого при наведении курсора или кликабельного, с надписью «Источники данных», который открывается в окне карты и предоставляет информацию об атрибуции. Всегда стремитесь поддерживать хорошие картографические методы.

Нижний колонтитул с логотипом Google и указанием поставщика данных.

Отображение атрибуции сторонних данных

Когда вы используете Map Tiles API для отображения данных Карт Google в качестве базовой карты и наложения сторонних (не Google) геопространственных данных, вам может потребоваться указать атрибуцию стороннего поставщика данных. Вы не должны каким-либо образом перекрывать или скрывать атрибуцию данных Google с атрибуцией сторонних данных. Атрибуция сторонних данных должна быть явно отделена от атрибуции данных Google. Кроме того, должно быть ясно, что логотип Google и атрибуция данных Google связаны с базовой картой и друг с другом.

Отображение атрибутов логотипа и данных в гибридных визуализациях

Когда вы используете данные Google Maps в качестве базовой карты при наложении собственных картографических данных, вы должны убедиться, что ваша аудитория полностью понимает, какая часть визуализации карты принадлежит Google, а какие части относятся к вашим собственным картографическим данным. Кроме того, следуйте рекомендациям, приведенным выше в разделе «Отображение логотипа Google» .

В качестве примера рассмотрим объединение фотореалистичных 3D-плиток (в качестве фона) с вашими собственными фотореалистичными моделями (на переднем плане). Пользователи могут запутаться в том, какие компоненты сцены взяты из данных Google Maps. В таких случаях вы должны четко указать в строке атрибуции пользовательского интерфейса или пользовательском потоке, какая часть сцены основана на данных Google Maps. Вы несете ответственность за соблюдение любых требований к атрибуции третьих сторон, которые могут применяться к источникам данных, которые вы используете с данными Google Maps.

Наложение геоданных с помощью фотореалистичных 3D-плиток

Вы можете накладывать свои собственные 3D-объекты на фотореалистичные 3D-плитки при условии, что 3D-объекты не извлекаются, не отслеживаются или иным образом не извлекаются из фотореалистичных 3D-плиток вручную или машиной.

Создание видеоролика с использованием Map Tiles API

  • Рекламные видеоролики . Вы можете создавать рекламные видеоролики в соответствии с условиями Соглашения и следующими условиями:
    • Рекламный видеоролик не должен включать изображения Street View.
    • Продолжительность рекламного ролика не должна превышать 30 секунд.
    • Рекламный видеоролик должен рассказывать о возможностях вашего приложения(й).
    • Рекламный видеоролик должен иметь четкую пометку «только для рекламных целей» и должен соответствовать рекомендациям по атрибуции, изложенным в правилах API плиток карты .
    • Рекламный видеоролик не может перепродаваться отдельно или как часть программного обеспечения, приложения или пользовательского опыта.
  • Удаление : вы несете ответственность за выполнение всех запросов на удаление рекламного видео, включая запросы третьих лиц.

Получите информацию об авторстве и авторских правах из поля copyright в ответах на следующие вызовы API, в зависимости от используемой вами службы:

2D плитка

Дорожная карта, плитки спутников и местности

Сведения об авторских правах и авторстве доступны в ответе с информацией об области просмотра, как показано в следующем примере.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

Плитка просмотра улиц

Информацию об авторских правах и авторстве можно получить в ответе на метаданные Просмотра улиц. Например:

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  
}

Идентификатор панорамы, который используется для уникальной идентификации панорамы Street View, не подпадает под ограничение кэширования. Таким образом, значения идентификаторов панорамы можно хранить неограниченное время. Значения идентификатора панорамы возвращаются в поле panoId в ответах статического API просмотра улиц.

Фотореалистичные 3D плитки

Для фотореалистичных 3D-плиток данные атрибуции возвращаются в каждом запросе плитки. Вы должны агрегировать, сортировать и отображать в строке все атрибуты отображаемых плиток; обычно в нижней части рендеринга. Например, вы можете найти атрибуцию данных в плитке glTF, просмотрев разделы asset , copyright .

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

ЦезийJS

Если вы используете CesiumJS в качестве средства визуализации, то для отображения атрибуции вам необходимо включить showCreditsOnScreen в HTML-код рендеринга.

// Add Photorealistic 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));

Цезий для Unreal

Если вы используете Cesium для Unreal в качестве средства визуализации, то для отображения авторства вам необходимо включить поле «Показать авторство на экране» в World Outliner .

Как включить атрибуцию для Cesium для Unreal

Цезий за единство

Если вы используете Cesium for Unity в качестве средства визуализации, то для отображения авторства вам необходимо включить поле «Показать авторство на экране» в консоли инспектора.

Как включить атрибуцию для Cesium для Unity

Рекомендации по стилю для атрибуции Google

Ниже приведены рекомендации по стилю атрибутов Google в CSS и HTML, если вы не можете использовать загружаемый логотип Google.

Освободить пространство

Объем свободного пространства вокруг блокировки должен быть равен или превышать высоту буквы «G» в Google.

Пространство между копией указания авторства и логотипом Google должно составлять половину ширины буквы G.

Разборчивость

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

Цвет

Используйте текст Google Material Grey 700 на белом или светлом фоне с максимальным оттенком черного в диапазоне 0–40%.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

На темном фоне, а также над фотографиями или незанятыми узорами используйте белый текст для подписи и указания авторства.

Google
#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;