Где управлять своим идентификатором клиента в Google Cloud Console
Функция управления идентификатором клиента плана Премиум доступна в Cloud Console в нижней части страницы «Учетные данные платформы Google Maps», в разделе «Идентификатор клиента» .
Доступ к дополнительным задачам управления идентификатором клиента, включая авторизацию URL-адресов и управление секретами подписи идентификатора клиента, можно получить на отдельной странице идентификатора клиента , щелкнув значок в правой части раздела «Идентификатор клиента» .
Важно! План Премиум платформы Google Карт больше недоступен для зарегистрированных и новых клиентов.
Обеспечение вашей команде доступа к необходимым ресурсам
Используйте облачную консоль Google
Почему это важно . Google Cloud Console предоставляет вам доступ к такой информации, как отчеты об использовании , ленты новостей и ресурсы для разработчиков. Что еще более важно, Cloud Console позволяет вам обращаться в службу поддержки платформы Google Maps, если у вас возникнут какие-либо технические проблемы во время разработки или запуска.
Перед запуском включите доступ к Cloud Console для всех разработчиков, ответственных за обслуживание вашего приложения. Если у вас возникнут технические проблемы, доступ к Cloud Console позволит членам вашей команды связаться со службой поддержки, а также позволит нашей команде поддержки связаться с соответствующими заинтересованными сторонами в вашей организации. Например, команде поддержки может потребоваться связаться с вашей организацией, если мы обнаружим аномальный трафик или поведение, которое может привести к поломке вашего приложения. Обеспечение возможности связаться с соответствующими разработчиками может сыграть решающую роль между неожиданным сбоем и его предотвращением.
Подписаться на группы уведомлений по электронной почте
Почему это важно . Чтобы быть в курсе событий и изменений в Maps API, мы рекомендуем подписаться на одну или несколько из следующих групп электронной почты:
- google-maps-platform-notifications — технические обновления API и веб-сервисов платформы Google Maps, уведомления о сбоях и объявления о функциях платформы (~ 3–5 сообщений в месяц).
- google-maps-js-api-v3-notify — новые выпуски API JavaScript Карт Google (~ 4 сообщения в год).
Оптимизация вашего приложения
Настройте брандмауэр, чтобы разрешить доступ к службам платформы Google Maps.
Почему это важно : службы платформы Google Maps используют множество доменов, некоторые из которых не принадлежат к домену *google.com . Если вы находитесь за ограничительным брандмауэром, важно разрешить доступ к доменам, используемым каждой службой API Карт. Если ваш брандмауэр не разрешает доступ к этим доменам, запросы API не будут выполнены, что может привести к поломке ваших приложений. См. полный список доменов, используемых API Карт .
Мы не рекомендуем управлять ограничениями брандмауэра по IP-адресу, поскольку IP-адреса, связанные с этими доменами, не являются статическими.
Примечание. Службы платформы Google Maps используют порты 80 (http) и 443 (https) для входящего и исходящего трафика. Этим службам также требуются запросы GET, POST, PUT, DELETE и HEAD. Настройте свой брандмауэр так, чтобы разрешать трафик через эти порты и разрешать запросы в зависимости от API и варианта использования.
Авторизуйте свои домены SSL для использования с API JavaScript Карт.
Почему это важно . При использовании 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 при каждой загрузке карты . См. руководство по тарифам и лимитам использования Премиум-плана .
Управляйте использованием квот веб-сервисов
Перед запуском службы очень важно понять различные ошибки, связанные с квотами (например, OVER_QUERY_LIMIT , User Rate Limit Exceeded ), и настроить правильную логику в своем приложении, чтобы иметь возможность реагировать на такие ошибки при превышении квоты. . Пожалуйста, начните с чтения часто задаваемых вопросов по ограничениям использования . Информацию о кодах состояния, возвращаемых каждым API, см. в руководстве разработчика для этого API. Например, см. руководство по кодам состояния Directions API . Понимание и реализация этих концепций значительно снизят вероятность того, что ваше приложение превысит разрешенную квоту, будет заблокировано Google или сломано.
Выполните нагрузочное тестирование вашего приложения.
Почему это важно . Используйте нагрузочное тестирование своего приложения, чтобы убедиться, что оно способно обрабатывать большие объемы запросов, не превышая квоты для API Карт.
Хотя платформа Google Maps может обрабатывать очень большие объемы трафика, тестирование с использованием действующих сервисов Google приведет к тому, что ваше приложение превысит разрешенную квоту и может быть заблокировано Google. Вы также несете ответственность за оплату использования, связанную с нагрузочным тестированием.
Вместо этого нагрузочное тестирование вашего приложения должно гарантировать, что оно способно обрабатывать большие объемы запросов, не превышая квоты для API Карт и не блокируясь Google. Чтобы безопасно добиться этого, выполните нагрузочное тестирование с использованием ложного (поддельного) API — службы, которая может обрабатывать большое количество запросов — и отвечайте на запросы действительными ответами без использования платформы Google Maps. Пример: если ваша квота для API геокодирования составляет 3000 QPM (запросов в минуту), нагрузочное тестирование вашего приложения должно гарантировать, что ваше приложение может обрабатывать гораздо больший объем, например 90 000 QPM, без отправки более 3000 QPM в API геокодирования.
Если вы планируете провести значительное нагрузочное тестирование, обратитесь в службу поддержки Google за инструкциями и убедитесь, что Google знает о запланированном вами тестировании.