Часто задаваемые вопросы

Эта страница предназначена только для пользователей, которые владеют лицензией на ранее выпускавшиеся продукты Maps APIs for Work или Maps API for Business. Эта страница не предназначена для пользователей нового продукта Google Maps APIs Premium Plan, который стал доступен в январе 2016 года.

В настоящем документе даются ответы на вопросы, относящиеся к лицензиям на предыдущие версии Google Maps APIs for Work.

См. документ Часто задаваемые вопросы по Google Maps APIs, чтобы получить информацию, общую для всех Google Maps APIs.

Начало работы

Ограничения на использование

Использование Google Maps APIs

KML

Подписи URL-адресов

Стилизация

Начало работы

Какие продукты входят в состав Google Maps APIs for Work?

В состав Google Maps APIs for Work входят следующие продукты Google. В отношении использующих эти продукты приложений действует Соглашение об уровне обслуживания Google Maps APIs for Work, и для них предоставляется техническая поддержка.

Следующие API не входят в состав Google Maps APIs for Work. Эти API должны использоваться в приложениях в соответствии с опубликованными условиями использования этих API. На них не распространяется Соглашение об уровне обслуживания Google Maps APIs for Work, и для них в настоящее время не предоставляется техническая поддержка.

Как обратиться в техническую поддержку по вопросам, связанным с Google Maps APIs for Work?

Пользователи Google Maps APIs for Work могут зарегистрировать новую заявку в службе поддержки Google, используя портал Google Cloud Support Portal по адресу:

https://google.secure.force.com/

Для доступа к порталу требуются имя пользователя и пароль. Заполните эту форму, если у вас нет учетной записи.

Как сбросить учетные данные для Google Cloud Support Portal?

Я забыл пароль. Данная ссылка также доступна на странице входа в Google Cloud Support Portal.

Что такое Условия использования для Google Maps APIs for Work?

Если вы являетесь пользователем Google Maps APIs for Work, условия использования Google Maps APIs приведены в вашем соглашении.

Ограничения на использование

Как отслеживается и отображается в отчетах использование Google Maps APIs for Work?
  • Для лицензий на Google Maps APIs for Work, Maps JavaScript API, Street View Image API и Static Maps API статистика использования рассчитывается на основе числа просмотров страниц.

    Просмотр страницы определяется следующим образом.

    1. Одна загрузка Google Maps JavaScript API на странице. Maps JavaScript API перезагружается при каждой перезагрузке страницы, использующей API. При взаимодействии пользователя с картой (сдвиг, изменение масштаба, смена типа карты) дополнительные просмотры страниц не генерируются. Однако просмотр страницы генерируется при загрузке API на странице, даже если API не используется для отображения карты. В связи с этим мы рекомендуем вместо включения в шаблоны страниц тега script, загружающего API, реализовать асинхронную загрузку API на страницах, где карты отображаются только в ответ на необязательные действия пользователя.
    2. Один запрос изображения Google Street View Image API или Google Static Maps API.

    Пользователи Google Maps APIs for Work могут отслеживать статистику просмотров страниц на Google Cloud Support Portal по адресу: https://google.secure.force.com/

    Приложения Google Maps APIs Standard и приложения Premium Plan имеют ограничения по числу загрузок карты, которые немного отличающиеся от ограничений по числу просмотров страниц. См. раздел Часто задаваемые вопросы по Google Maps APIs для получения дополнительной информации.

  • В Google Maps Mobile SDK for Work использование отслеживается по числу загрузок карты. Дополнительную информацию см. в документе ограничения на использование Google Maps Mobile SDK.
  • Отслеживание использования веб-служб Google Maps APIs ведется по запросам (для Google Maps Distance Matrix API в этих целях учитываются элементы). Дополнительную информацию см. в документе ограничения на использование веб-служб Google Maps APIs.
Какие ограничения на использование предусмотрены для Google Maps JavaScript API?

Запросы, считающиеся просмотрами страниц (в соответствии с определением выше), вычитаются из общего лимита просмотров страниц по лицензии на Google Maps APIs for Work. После достижения этого лимита необходимо срочно обновить лицензию.

Какие ограничения на использование предусмотрены для Google Maps Mobile SDK for Work?

Каждая операция загрузки карты вычитается из общего лимита загрузок карты по лицензии на Google Maps Mobile SDK for Work. После достижения этого лимита необходимо срочно обновить лицензию. Дополнительную информацию см. в документе ограничения на использование Google Maps Mobile SDK.

Какие ограничения на использование предусмотрены для веб-служб Google Maps APIs?

Пользователям Google Maps APIs for Work выделяются следующие лимиты использования веб-служб Google Maps APIs.

Веб-служба Ограничения
Служба Directions Ежедневная квота от 100 000 запросов в течение 24 часов при покупке годовой лицензии. До 23 промежуточных точек в запросе. Лимит частоты – 10 запросов в секунду.
Служба Elevation Ежедневная квота от 100 000 запросов в течение 24 часов при покупке годовой лицензии. До 512 точек на запрос. Лимит частоты – 10 запросов в секунду.
Служба Geocoding Ежедневная квота от 100 000 запросов в течение 24 часов при покупке годовой лицензии. Лимит частоты – 10 запросов в секунду.
Служба Distance Matrix Ежедневная квота от 100 000 элементов в течение 24 часов при покупке годовой лицензии. До 625 элементов на запрос и до 1 000 элементов за 10 секунд.
Служба Time Zone Ежедневная квота от 100 000 запросов в течение 24 часов при покупке годовой лицензии. Лимит частоты – 10 запросов в секунду.
Служба Roads Ежедневная квота от 100 000 запросов в течение 24 часов при покупке годовой лицензии. Лимит частоты – 10 запросов в секунду. Каждый запрос может содержать до 100 точек.

Эти лимиты действуют для каждого идентификатора клиента Google Maps APIs for Work или проекта разработчика и являются общими для всех приложений и IP-адресов, которые используют этот идентификатор клиента или проект разработчика.

Если вам требуются более высокие лимиты использования, свяжитесь со своим менеджером по работе с клиентами Google Maps APIs for Work для получения информации о приобретении.

Какие ограничения на использование предусмотрены для Google Places API и Google Maps Geolocation API?

Если вы приобрели Google Places API или Google Maps Geolocation API по договору на Google Maps APIs for Work, ваши лимиты будут указаны в разделе Quotas в Google API Console. Если вам требуются более высокие лимиты, свяжитесь с Google через Google Cloud Support Portal.

Какие ограничения на использование предусмотрены для запросов геокодирования, направляемых из Google Maps JavaScript API?

Пользователям Google Maps APIs for Work предоставляются следующие лимиты использования, действующие для запросов геокодирования из Maps JavaScript API.

Служба Используемый API  Ограничения
Служба Geocoding
Google Maps JavaScript API

Для геокодирования действует дневной лимит и лимит частоты запросов для каждого пользовательского сеанса вне зависимости от числа пользователей с данным IP-адресом.

Эту службу не следует использовать для пакетных операций геокодирования. Для таких операций рекомендуется использовать Google Maps Geocoding API.

Что такое ограничения на использование API изображений Google Maps?

Пользователям Google Maps APIs for Work выделяются следующие лимиты использования API изображений Google Maps.

Служба Ограничения
Google Static Maps API

Запросы вычитаются из общего лимита просмотров страниц, приобретенного по лицензии Google Maps APIs for Work.

Максимальный размер изображения составляет 2048 на 2048 пикселей. Этот размер вычисляется в виде произведения значений size и scale, как объясняется ниже.

Google Street View Image API

Запросы вычитаются из общего лимита просмотров страниц, приобретенного по лицензии Google Maps APIs for Work.

Максимальный размер изображения составляет 2048 на 2048 пикселей.


Можно запрашивать изображения Google Static Maps API размером до 2048x2048 пикселей. Поскольку значение scale в запросе статической карты влияет на количество отображаемых пикселей, максимальное значение параметра size отличается для каждого уровня масштаба:

Развитие Макс. размер Возвращаемые результаты
1 2048x2048 2048x2048
2 1024x1024 2048x2048
4 512x512 2048x2048

Google Street View Image API не поддерживает параметр scale.

Использование Google Maps APIs

Какие ключи или учетные данные необходимо использовать для различных продуктов на основе Google Maps APIs?

При каждом использовании Google Maps APIs необходимо указывать учетные данные для подтверждения запроса. Тип требуемых учетных данных зависит от того, какие API используются по лицензии Google Maps APIs for Work. Для большинства API требуется использовать идентификатор клиента. В некоторых случаях требуется ключ API.

  • Идентификатор клиента: Идентификатор клиента предоставляется вам при регистрации в качестве пользователя Google Maps APIs for Work.

    Пример загрузки API с идентификатором клиента: &client=gme-companyname

  • Цифровая подпись: Как правило, цифровая подпись используется пользователями Google Maps APIs for Work при аутентификации с помощью идентификатора клиента. Она создается с помощью криптографического ключа, предоставленного вам Google.
  • Ключ API: Ключ API – это уникальный идентификатор, создаваемый с помощью Google API Console. Ключи API обычно используются со стандартными API. Пользователи Google Maps APIs for Work обычно используют идентификаторы клиента, хотя некоторые API требуют использовать вместо них ключи API. Для тех API, которым требуется ключ API, его можно использовать без применения ограничений (такой ключ называется "универсальным ключом API") или с ограничениями, применение которых обеспечивает дополнительную защиту (рекомендуемый вариант). API-интерфейсы на любой платформе могут использовать универсальный ключ API.

    Если добавить в ключ API ограничение (например, IP-адрес), то ключ с ограничением будет работать только на платформах, поддерживающих это ограничение. Ниже приведены четыре типа ограничений, предусмотренных для ключа API.

    • Ограничение для сервера (по IP-адресу) – для использования с интерфейсами API веб-служб.
    • Ограничение для браузера (по источникам ссылок HTTP) – для использования с интерфейсами Web API.
    • Ограничение для приложения Android (по имени пакета и контрольной сумме) – для использования с интерфейсами Android API.
    • Ограничение для приложения iOS (по идентификатору пакета iOS) – для использования с интерфейсами iOS API.

    Интерфейсы API на одной и той же платформе могут использовать одинаковый ключ с ограничениями.

    Примечание. При создании ключа на Google API Console пользователи Google Maps APIs for Work должны выбрать проект, созданный для них при регистрации. Данный проект будет содержать в названии слово Business или Work.

    Пример загрузки API с ключом: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

В таблице ниже приводятся учетные данные, которые необходимо использовать с каждым продуктом Google Maps APIs. (Как указано выше, для ключа API предусмотрены следующие типы ограничений: для сервера, для браузера, для Android и для iOS).

API Пользователи Google Maps APIs for Work
Google Maps Android API Ключ API с ограничением для Android
Google Places API for Android недоступно
Google Maps SDK for iOS Ключ API с ограничением для iOS
Google Places API for iOS недоступно
Google Maps JavaScript API Идентификатор клиента
Google Static Maps API Идентификатор клиента + цифровая подпись
Google Street View Image API Идентификатор клиента + цифровая подпись
Google Maps Embed API недоступно
Google Maps Directions API Идентификатор клиента + цифровая подпись
Google Maps Distance Matrix API Идентификатор клиента + цифровая подпись
Google Maps Elevation API Идентификатор клиента + цифровая подпись
Google Maps Geocoding API Идентификатор клиента + цифровая подпись
Google Maps Geolocation API Ключ API с ограничением для сервера
Google Maps Roads API Ключ API с ограничением для сервера
Google Maps Time Zone API Идентификатор клиента + цифровая подпись
Google Places API Web Service Ключ API с ограничением для сервера
Как получить доступ к Google Maps APIs, используя идентификатор клиента Google Maps APIs for Work со страницы, загруженной по протоколу HTTPS (SSL)?

Чтобы получить доступ к Google Maps APIs со страницы, загруженной по протоколу HTTPS, нужно предварительно авторизовать URL-адреса HTTPS, с которыми вы хотите использовать API.

Как загрузить Google Maps JavaScript API по протоколу HTTPS (SSL) с использованием параметра base_domain загрузчика Common Loader?

Загрузить Maps JavaScript API по протоколу SSL, используя общий загрузчик с установленным параметром base_domain, нельзя.

Параметр base_domain не влияет на производительность приложения. Запросы API всегда обрабатываются наиболее подходящим для конкретного положения пользователя сервером Google Maps, вне зависимости от того, из какого домена загружается API.

Параметр base_domain устанавливает предпочтительные результаты геокодирования для заданной области. Чтобы получить тот же эффект без параметра base_domain, нужно установить параметр region для службы геокодирования.

KML

Как прорисовать на карте файлы KML, хранящиеся на узлах внутренней сети?

Класс KmlLayer, создающий наложения KML в Google Maps JavaScript API, использует размещенную в Google для получения и синтаксического анализа файлов KML для прорисовки. Поэтому файлы KML, которые не хранятся по общедоступному URL-адресу или требуют аутентификации для доступа, отобразить невозможно.

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

Подписи URL-адресов

Можно ли подписывать URL-адреса с помощью JavaScript?

Мы настоятельно не рекомендуем использовать JavaScript для подписи URL-адресов, поскольку в этом случае конечные пользователи могут получить доступ к вашему ключу шифрования. Поэтому подписи должны генерироваться только компонентами на стороне сервера.

Почему я получаю ответ HTTP 403 Forbidden на мои запросы веб-службы Google Maps APIs?

Ошибка "HTTP 403" означает проблемы с разрешениями доступа, вероятно вызванные невозможностью подтвердить подпись для этого запроса. Это может быть связано со следующими причинами.

  1. Подпись указана, но является некорректной для этого запроса.
  2. В запросе указан идентификатор клиента Google Maps APIs for Work, но не указана подпись, а вызываемая веб-служба требует, чтобы все запросы, отправляемые с использованием идентификатора клиента, содержали действительную подпись.
  3. Подпись указана, но не указан связанный с ней идентификатор клиента Google Maps APIs for Work.

Стилизация

Почему на карте не отображаются организации?

При загрузке карты с помощью Google Maps JavaScript API с параметром client отображение организаций на карте по умолчанию отключено. Чтобы включить его, нужно добавить на карту код стилизации:

var styles = [
  {
    featureType: 'poi.business',
    stylers: [
      { visibility: 'on' }
    ]
  }
];

map.setOptions({styles: styles});