Контрольный список перед началом использования

Управление идентификатором клиента в Google Cloud Console

Функции управления идентификатором клиента (тарифный план Premium) доступны в Cloud Console. В этом сервисе нужно открыть страницу учетных данных платформы Google Карт и найти раздел Client ID (Идентификатор клиента) в ее нижней части.

Новый раздел Client ID (Идентификатор клиента) на странице Credentials (Учетные данные)

Чтобы выполнить какие-либо действия с идентификатором клиента, например авторизовать URL или получить секрет для подписания, перейдите на страницу Client ID (Идентификатор клиента). Для этого в разделе Client ID (Идентификатор клиента) справа вверху нажмите на значок редактирования ().

Примечание. Тарифный план Premium платформы Google Карт больше не доступен для оформления.

Обеспечение доступа к необходимым ресурсам

Используйте Google Cloud Console

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

Перед запуском обеспечьте доступ к Cloud Console всем разработчикам, отвечающим за обслуживание вашего приложения. Это позволит участникам вашей команды обращаться в службу поддержки при возникновении технических проблем. Кроме того, специалисты нашей службы поддержки смогут связываться с ответственными лицами вашей организации (например, если мы обнаружим аномальный трафик или события, которые могут привести к нарушению работы вашего приложения). Таким образом, мы сможем предотвращать внезапные сбои в работе приложения.

Подпишитесь на группы уведомлений

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

  • google-maps-platform-notifications – новости об API и веб-сервисах платформы Google Карт, уведомления о сбоях и сообщения о новых функциях платформы (около 3–5 в месяц);
  • google-maps-js-api-v3-notify – сообщения о новых выпусках Google Maps JavaScript API (около 4 в год).

Оптимизация приложения

Настройте брандмауэр, чтобы разрешить доступ к сервисам платформы Google Карт

Почему это важно. Сервисы платформы Google Карт используют разные домены, и некоторые из них не являются дочерними доменами *google.com. Если у вас брандмауэр со строгими ограничениями, очень важно разрешить доступ к доменам, которые используются каждым из сервисов Maps API. Если ваш брандмауэр запрещает доступ к таким доменам, запросы к API не будут выполняться. Из-за этого в работе ваших приложений может возникнуть сбой. Ознакомьтесь с полным списком доменов, используемых Maps API.

Мы не рекомендуем настраивать правила брандмауэра по IP-адресам, поскольку для этих доменов используются динамические IP-адреса.

Примечание. Сервисы платформы Google Карт используют для входящего и исходящего трафика порты 80 (http) и 443 (https). Для этих сервисов также требуются запросы GET, POST, PUT, DELETE и HEAD. Настройте правила брандмауэра, разрешающие трафик через эти порты и выполнение запросов (в зависимости от API и варианта использования).

Разрешите использовать ваши домены SSL с Maps JavaScript API

Почему это важно: при использовании Maps JavaScript API с доменом SSL обязательно нужно явным образом авторизовать ваши домены HTTPS, чтобы запросы вашего приложения не отклонялись. Обратите внимание, что в результате авторизации домена http://yourdomain.com эквивалентный домен SSL https://yourdomain.com не авторизируется автоматически. Чтобы посмотреть список авторизованных доменов в Cloud Console, прокрутите страницу вниз до раздела Идентификатор клиента. Для устранения неполадок при использовании клиентского API с доменом SSL проверьте, не загружаются ли какие-либо элементы страницы по протоколу HTTP. Подробные инструкции доступны в руководстве.

Выберите подходящую версию API

Почему это важно. До начала разработки приложения необходимо выяснить, какие версии API устарели. Использование при разработке актуальных версий API позволит сэкономить время разработчиков и расходы, связанные с прекращением поддержки устаревших версий.

В частности, важно понимать схему определения версий Maps JavaScript API, чтобы случайно не использовать неподходящую версию API в своей среде.

Например, экспериментальную версию API можно использовать в среде разработки или тестирования, но мы настоятельно не рекомендуем использовать ее в рабочей среде. Наше соглашение об уровне обслуживания действует только для стабильных версий API, поэтому в рабочей среде следует использовать только такие версии.

Дополнительные сведения вы можете найти в руководстве по версиям Maps JavaScript API.

Выберите клиентское или серверное решение

Почему это важно. Выбор серверного или клиентского подхода определяет архитектуру приложения и очень важен для его стабильности и масштабируемости. Как правило, серверный подход используется для автономной предварительной и постобработки записей (вне вашего приложения). Клиентский подход следует использовать для тех частей ваших приложений, с которыми взаимодействуют пользователи (т. е. для обработки запросов пользователей в режиме реального времени).

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

Оптимизируйте использование квоты

Почему это важно. Понимая, как ваше приложение использует квоту кредитов Maps API, вы сможете сократить расходы. Например, если вы используете Maps JavaScript API, ваше приложение расходует кредиты Maps API при каждой загрузке карты. Подробные сведения приведены в статье Ограничения и цены на использование в тарифном плане Premium.

Управляйте использованием квоты для веб-сервисов

Прежде чем запускать сервис, важно узнать о распространенных ошибках, связанных с квотами (например, OVER_QUERY_LIMIT, User Rate Limit Exceeded), и предусмотреть, как приложение будет реагировать на такие ошибки в случае превышения квоты. Для начала ознакомьтесь с часто задаваемыми вопросами по лимитам на использование. Информацию по кодам статуса, возвращаемых каждым API, можно найти в руководстве для разработчиков по этому API (например, в руководстве по по кодам статуса Directions API). Если вы будете понимать и использовать эти концепции, вероятность превышения разрешенной квоты, блокировки со стороны Google или потери работоспособности вашего приложения будет минимальной.

Проведите нагрузочное тестирование вашего приложения

Почему это важно. Используйте нагрузочное тестирование приложения, чтобы убедиться в возможности обработки большого объема запросов без превышения квот Maps API.

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

Нагрузочное тестирование помогает проверить, может ли ваше приложение справляться с большим объемом запросов без превышения квоты Maps API и блокировки со стороны Google. Чтобы безопасно достичь этого, выполните нагрузочное тестирование с использованием фиктивного API. Это сервис, который может обрабатывать большое количество запросов и отправлять ответы на них, не используя платформу Google Карт. Пример. Если ваша квота для Geocoding API составляет 20 запросов в секунду, во время нагрузочного тестирования ваше приложение должно обрабатывать 600 запросов/сек, отправляя не более 20 запросов/сек в Geocoding API.

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