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

Часто задаваемые вопросы о платформе Google Карт

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

Что такое платформа Google Карт?

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

Maps:

Routes:

Places:

Environment:

Как начать работу с платформой Google Карт?

Прочитайте статью о начале работы с платформой Google Карт.

Какие API мне нужны?

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

Как начать работу с API на своем сайте?

Изучите обзорное руководство, руководство для разработчика и руководство по началу работы для конкретных API или SDK, которые вас интересуют. Например, можно посмотреть руководства по Maps SDK для Android или Maps JavaScript API.

В каких странах доступна платформа Google Карт?

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

См. также:

Как изменить язык продуктов платформы Google Карт с английского на другой?
В каких странах доступны маршруты на общественном транспорте?

Можно ли разместить Google Карты на своем сайте, не используя продукты платформы Google Карт?

Да. Google Карты теперь позволяют встраивать карты в сайт или блог без навыков программирования или использования платформы Google Карт. Более подробную информацию можно найти здесь.

Как интегрировать Google Карты в приложения для мобильных устройств?

Чтобы добавить карты в приложение для Android, воспользуйтесь Maps SDK для Android.

Чтобы добавить карты в приложение для iOS, воспользуйтесь Maps SDK для iOS.

Интерфейс Maps JavaScript API специально разработан для мобильных устройств. Он одинаково пригоден для приложений на компьютерах и мобильных устройствах, включающих браузеры с полной реализацией JavaScript (например, iPhone).

Для устройств, которые не поддерживают Maps JavaScript API, подойдет Maps Static API – в нем используются карты в виде статичных изображений GIF, JPG и PNG с маркерами и ломаными линиями. Обратите внимание, что при использовании Maps Static API вне браузерных приложений изображение карты необходимо связывать с Google Картами.

Какие веб-браузеры поддерживает Maps JavaScript API и Maps Embed API?

Maps JavaScript API и Maps Embed API поддерживают следующие браузеры:

Компьютер

Текущая версия Microsoft Edge (Windows), кроме режима IE.
Две последние основные и стабильные версии Firefox (Windows, macOS, Linux).
Две последние основные и стабильные версии Chrome (Windows, macOS, Linux).
Две последние основные и стабильные версии Safari (macOS).

Android

Текущая версия Chrome на Android 4.1+.
Chrome WebView на Android 4.4+.

iOS

Мобильная версия Safari для текущей и предыдущей основной версии iOS.
UIWebView и WKWebView для текущей и предыдущей основной версии iOS.
Текущая версия Chrome для iOS.

Можно ли распечатывать карты из Maps JavaScript API?

Печать из Maps JavaScript API не поддерживается. Это связано с тем, что в наиболее распространенных браузерах поддержка печати реализована по-разному.

Как узнавать об изменениях в продуктах платформы Google Карт?

Чтобы быть в курсе новостей обо всех географических продуктах Google для разработчиков, подпишитесь на блог платформы Google Карт.

Как связаться со службой технической поддержки?

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

В какое время работает служба технической поддержки?

Служба поддержки решает проблемы с доступностью сервисов круглосуточно 5 дней в неделю (с 9:00 понедельника по времени Токио до 17:00 пятницы по тихоокеанскому времени), кроме региональных праздничных дней.

Как восстановить доступ к аккаунту Google?

При потере доступа к аккаунту Google (например, ivan@mycompany.com или ivan@gmail.com) вы можете восстановить его, получив или сбросив пароль. Изучите статью Как восстановить доступ к Gmail или аккаунту Google.

Примечание. Для восстановления доступа к аккаунту G Suite обратитесь к администратору своей организации.

Как восстановить доступ к проекту?

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

Если у вас есть доступ к проектам, связанным с аккаунтом Google:

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

Если у вас нет доступа к аккаунту Google, связанному с проектом:

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

Можно ли использовать Maps SDK и Places SDK для iOS на компьютерах Mac с ARM-процессором?

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

Условия использования

Каковы условия использования продуктов платформы Google Карт?

С Условиями использования платформы Google Карт можно ознакомиться здесь:

https://cloud.google.com/maps-platform/terms

Соответствует ли мой сайт Условиям использования платформы Google Карт?

Ознакомьтесь с Условиями использования платформы Google Карт. Если ваш сайт отвечает всем требованиям, то вы можете использовать ее в своих приложениях.

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

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

Есть ли прямой доступ к фрагментам карт и спутниковым снимкам?

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

Можно ли использовать продукты платформы Google Карт в приложениях для отслеживания местоположения?

Если приложение соответствует Условиям использования платформы Google Карт, то ограничений на показ данных (отслеживание местоположения) в реальном времени с помощью продуктов платформы Google Карт нет.

Можно ли использовать продукты платформы Google Карт в автономных приложениях без веб-доступа?

Да, продукты платформы Google Карт теперь можно использовать для автономных приложений, если эти приложения соответствуют Условиям использования платформы Google Карт.

Maps JavaScript API поддерживает только указанные в этом списке браузеры.

Можно ли использовать продукты платформы Google Карт на сайте, защищенном паролем?

Да, сервисы Maps, Routes, Places и Environment от Google можно использовать в приложениях с закрытым доступом. Более подробную информацию можно найти в Условиях использования платформы Google Карт.

Можно ли создать приложение, в котором данные платформы Google Карт будут включаться в документ?

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

Как отказаться от показа своего контента в результатах поиска Google?

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

Чтобы удалить страницу или сайт из результатов поиска, следуйте инструкциям в нашем Справочном центре.

Можно ли создавать изображения с помощью Maps Static API, а затем сохранять их на своем сайте для показа пользователям?

Нет, если на веб-странице содержится статичное изображение карты, оно должно загружаться непосредственно из Maps Static API. Адрес можно указать в атрибуте src HTML-тега img или в CSS-атрибуте background-image HTML-тега div.

Тарификация и лимиты на использование

Как настроить платежные функции для проекта?

См. информацию о начале работы с платформой Google Карт.

Что такое бесплатный пробный период Google Cloud и как перейти на платный аккаунт?

Бесплатный пробный период Google Cloud длится 91 день и позволяет новым пользователям без каких-либо финансовых обязательств опробовать самые популярные продукты Google Cloud, в том числе API платформы Google Карт (GMP). При регистрации бесплатной пробной версии создается платежный аккаунт с 300 долларами США на балансе, которые можно потратить на платформу Google Карт.

Если вы не перейдете на платный платежный аккаунт в течение 91 дня или израсходуете бесплатный кредит в размере 300 долларов США, ваш платежный аккаунт для бесплатного пробного периода будет закрыт, а все связанные с ним проекты и ресурсы будут остановлены. Чтобы сохранить ресурсы, созданные во время бесплатного пробного периода, и продолжить пользоваться сервисами без перебоев, перейдите на платный платежный аккаунт. Подробнее о бесплатном пробном периоде…

Есть ли у платформы Google Карт лимиты на использование (квоты)?

Для продуктов платформы Google Карт не существует ограничений на использование в течение дня или на количество запросов. Ограничивается только максимальное количество запросов в минуту.

В таблице ниже приведены лимиты на использование каждого API. Посмотреть и изменить лимиты квот можно в Cloud Console.

API	Лимит на использование
Address Validation	6000 запросов в минуту
Aerial View: Lookup Video	180 запросов в минуту и 100 000 запросов в день
Aerial View: Render Video	100 запросов в минуту и 100 запросов в день
Air Quality	6000 запросов в минуту
Maps JavaScript API: 3D-карты	30 000 запросов в минуту
Maps JavaScript API: динамические карты	30 000 запросов в минуту
Elevation	6000 запросов в минуту
Geocoding	3000 запросов в минуту
Geolocation	6000 запросов в минуту
Maps Grounding Lite: поиск мест, просмотр погоды, построение маршрутов	300 запросов в минуту на инструмент
Maps Grounding Lite: разрешение названий, разрешение URL Карт	600 запросов в минуту на метод.
Map Tiles API: двумерные фрагменты карт	6000 запросов в минуту и 15 000 запросов в день
Map Tiles API: фрагменты просмотра улиц	6000 запросов в минуту и 15 000 запросов в день
Map Tiles API: фотореалистичные трехмерные фрагменты	12 000 запросов в минуту и 10 000 корневых запросов в день.
Навигация: запросы на установку пункта назначения	30 000 запросов в минуту
Места	6000 запросов в минуту
Places Aggregate	1200 запросов в минуту
Пыльца	6000 запросов в минуту
Roads	30 000 запросов в минуту
Routes: получение маршрутов	3000 запросов в минуту
Routes: получение матрицы маршрутов	3000 элементов в минуту
Solar	600 запросов в минуту
Static Maps	30 000 запросов в минуту
Street View Image API	30 000 запросов в минуту
Time Zone	30 000 запросов в минуту
Погода	6000 запросов в минуту

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

Продукты платформы Google Карт нужно развертывать в соответствии с Условиями использования платформы Google Карт.

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

С ценами на продукты платформы Google Карт можно ознакомиться в этой таблице.

Подробнее о том, как взимается плата за API платформы Google Карт…

Как подсчитывается количество загрузок карт на платформе Google Карт?

Плата за одну загрузку карты взимается при выполнении любого из следующих условий:

карта отображается на веб-странице или в приложении с помощью Maps JavaScript API;
приложение запрашивает одно изображение карты из Maps Static API.

Панорамы в Просмотре улиц оплачиваются отдельно от загрузки карт:

статическая (не интерактивная) панорама в Просмотре улиц оплачивается за каждый запрос к Street View Static API на встраивание статической панорамы;
динамическая панорама в Просмотре улиц оплачивается за каждый экземпляр объекта панорамы в приложении с Maps JavaScript API, Maps SDK для Android или Maps SDK для iOS.

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

Если добавить маркер, дополнительных загрузок карты не будет, но возможны расходы из-за определения местоположения маркера, например загрузки или повторной загрузки класса google.maps.Map().

Как отслеживать использование?

Вы можете контролировать использование отдельных API с помощью консоли Google Cloud.

Выберите проект с нужным API.
В списке API на панели инструментов выберите название API.
В верхней части страницы нажмите Metrics (Показатели) или Quotas (Квоты).

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

Настройте платежные функции.
Перейдите на страницу оплаты в Cloud Console.
Выберите проект.
На левой боковой панели выберите Reports (Отчеты). С помощью фильтров на правой боковой панели посмотрите отчеты по своему платежному аккаунту.

Более подробная информация приведена в статьях об отчетах платформы Google Карт, мониторинге платформы Google Карт и установке лимита квоты.

Что произойдет при превышении лимитов на частоту запросов (QPM)?

При превышении лимитов частоты запросов для конкретного продукта платформы Google Карт API выдаст сообщение об ошибке. При постоянном превышении лимитов ваш доступ к этому API может быть временно заблокирован.

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

Примечание. Для следующих API веб-сервисов в Maps JavaScript API доступен равнозначный клиентский сервис: Elevation и Geocoding.

Превышение лимитов на использование

При превышении лимитов на использование вы будете получать в ответ на запрос код статуса OVER_QUERY_LIMIT.

Это означает, что веб-сервис перестанет предоставлять обычные ответы и будет возвращать только код статуса OVER_QUERY_LIMIT до тех пор, пока использование не будет разрешено снова. Это может продолжаться несколько секунд, если ошибка связана с отправкой слишком большого числа запросов в минуту.

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

На моем сайте большой трафик. Можно ли мне использовать продукты платформы Google Карт?

Да. Однако мы рекомендуем ознакомиться с лимитами на использование платформы Google Карт, которые применимы к вашему приложению.

Если популярность моего сайта или приложений резко возрастет, перестанут ли работать мои карты?

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

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

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

Сколько стоит использование платформы Google Карт?

Стоимость для каждого API приведена в таблице цен. Если ваше приложение создает запросы на загрузку карт в пределах бесплатной квоты на месяц, эта возможность предоставляется бесплатно. Превышение лимита будет оплачиваться с вашего платежного аккаунта. Подробнее об оплате использования платформы Google Карт…

Доступны ли цены в других валютах?

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

У меня настроены платежные функции. Как посмотреть счет?

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

Дополнительные ресурсы:

Как избежать крупных расходов при непредвиденном увеличении объемов трафика?

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

Как установить ограничение на количество тарифицируемых запросов в день

Чтобы не получать большие счета из-за непредвиденного роста объемов использования, можно установить дневное ограничение. Вы можете изменить это ограничение в Cloud Console.

Как настроить оповещения о бюджете и управлять ими

Вы можете настроить отправку оповещений на адреса электронной почты ответственных за оплату администраторов, если сумма счета достигает заданного порога. Администраторы получат оповещения, если сумма счета превысит 50 %, 90 % и 100 % от заданного порогового значения.

Мне пришло сообщение о том, что мой проект связан с "переходным аккаунтом платформы Google Карт", но у меня нет доступа к этому аккаунту. Что делать?

Переходный аккаунт платформы Google Карт предназначен для того, чтобы помочь некоторым клиентам перейти на наш тарифный план с оплатой по мере использования. Этот аккаунт позволяет Google единовременно выдавать пользователям средства, чтобы они могли и далее использовать платформу Google Карт в пределах лимита бесплатного плана. При превышении лимита платежный аккаунт будет отключен и вы потеряете доступ к сервису. Чтобы избежать перебоев в работе сервисов, мы рекомендуем настроить отдельный платежный аккаунт и далее пользоваться бесплатным планом с лимитом в 200 долл. США. Чтобы изменить платежный аккаунт для проекта, выполните следующие действия:

Создайте платежный аккаунт (если он у вас уже есть, пропустите этот шаг).
Свяжите платежный аккаунт со своим проектом.

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

Если вы не создали и не прикрепили к проекту платежный аккаунт, ваши API платформы Google Карт будут ограничены одним запросом в день. Вы можете получить большую квоту, создав и прикрепив платежный аккаунт. Подробнее…

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

Мне пришло уведомление о нарушениях, связанных с оплатой. Как решить этот вопрос?

Вы получили это уведомление, поскольку, по данным Google, в вашем аккаунте используется несколько платежных аккаунтов. Таким образом вы нарушаете Условия использования платформы Google Карт. Создавать несколько платежных аккаунтов запрещено. Подробнее…

Как использовать платформу Google Карт

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

При каждом использовании продуктов платформы Google Карт вы должны указывать ключ API для подтверждения запроса. Платформа Google Карт доступна для Android, iOS, веб-приложений, а также через веб-сервисы HTTP.

Ключ API

Ключ API – это уникальный идентификатор, создаваемый с помощью Cloud Console.
Пример загрузки API с использованием ключа: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Цифровая подпись

Цифровая подпись создается на основе секрета для подписания URL, который вы получили от компании Google. Цифровые подписи используются с Maps Static API и Street View Static API.

Ограничения

Ограничения ключа API необязательны, но для повышения безопасности мы настоятельно рекомендуем ограничить все ключи API. Подробную информацию вы найдете в рекомендациях по обеспечению безопасности доступа к API.
К ключу API можно добавить ограничение по типу приложений. Если это сделать, ключ будет работать только на тех платформах, которые поддерживают выбранное ограничение. Ниже указано, какие ограничения по типу приложений можно задать. API с одинаковым типом ограничений могут совместно использовать один ключ с ограничением.
- IP-адреса (отдельные серверы) – для использования с API веб-сервиса.
- Заголовки HTTP referer (сайты) – для использования с веб-API.
- Ограничение по типу приложений для Android (по названию пакета и цифровому отпечатку) – для использования с Maps SDK для Android.
- Ограничение по типу приложений для iOS (по идентификатору пакета iOS) – для использования с Maps SDK для iOS.
Также вы можете добавить к ключу API ограничение API. Подробнее о том, как создать ключ API и задать для него ограничения…

В таблице ниже приведены ограничения ключа/учетных данных и приложений для каждого API и SDK платформы Google Карт.

API/SDK	Ограничение по учетным данным и типу приложений
Maps SDK для Android	Ключ API с ограничением для Android¹
Places SDK для Android	Ключ API с ограничением для Android¹
Navigation SDK для Android	Ключ API с ограничением для Android¹
Maps SDK для iOS	Ключ API с ограничением для iOS¹
Places SDK для iOS	Ключ API с ограничением для iOS¹
Navigation SDK для iOS	Ключ API с ограничением для iOS¹
Maps JavaScript API	Ключ API с ограничением по заголовку HTTP referer¹
Map Tiles API	Ключ API с ограничением по IP-адресу¹
Maps Datasets API	Токен OAuth
Aerial View API	Ключ API с ограничением по IP-адресу¹
Maps Static API	Ключ API с ограничением по заголовку HTTP referer¹ + цифровая подпись²
Street View Static API	Ключ API с ограничением по заголовку HTTP referer¹ + цифровая подпись²
Maps Embed API	Ключ API с ограничением по заголовку HTTP referer¹
Address Validation API	Ключ API с ограничением по IP-адресу¹
Elevation API	Ключ API с ограничением по IP-адресу¹
Geocoding API	Ключ API с ограничением по IP-адресу¹
Geolocation API	Ключ API с ограничением по IP-адресу¹
Places API	Ключ API с ограничением по IP-адресу¹
Places Aggregate API	Ключ API с ограничением по IP-адресу¹
Roads API	Ключ API с ограничением по IP-адресу¹
Routes API	Ключ API с ограничением по IP-адресу¹
Time Zone API	Ключ API с ограничением по IP-адресу¹
Air Quality API	Ключ API с ограничением по IP-адресу¹
Pollen API	Ключ API с ограничением по IP-адресу¹
Solar API	Ключ API с ограничением по IP-адресу¹
Weather API	Ключ API с ограничением по IP-адресу¹

¹Ограничения ключа API необязательны, но для повышения безопасности мы настоятельно рекомендуем ограничить все ключи API.

²В зависимости от сценария использования для Maps Static API и Street View Static API может требоваться цифровая подпись. В любом случае мы настоятельно рекомендуем применять для аутентификации запроса и ключ API, и цифровую подпись.

Как изменить тип ограничений для ключа, чтобы вместо ограничения по заголовку HTTP referer использовать ограничение по IP-адресу?

Важно! При использовании любого из API веб-сервисов с ключом API, который имеет ограничения по заголовку HTTP referer, запросы будут завершаться ошибкой с сообщением API keys cannot have referer restrictions when used with this API (При использовании с этим API ключи API не могут иметь ограничений по заголовку HTTP referer). Вам следует перейти на использование ключа API с ограничением по IP-адресу.

Прежде чем менять ограничение по заголовку HTTP referer на ограничение по IP-адресу, убедитесь, что все API, которые используют этот ключ API, поддерживают ограничения по IP-адресу. API с одинаковым типом ограничений могут совместно использовать один ключ с ограничением. Если нужно применять несколько ограничений, добавьте отдельный ключ с нужным типом ограничения. Подробнее о том, как добавить новый ключ API…

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

Чтобы вместо ограничения ключа API по заголовку HTTP referer использовать ограничение по IP-адресу, выполните следующие шаги:

Откройте страницу Credentials (Учетные данные) в Cloud Console.
Выберите проект, содержащий ключ API, который нужно изменить.
На странице Credentials (Учетные данные) выберите нужный ключ API из списка.
В разделе Key restriction (Ограничение для ключа) на этой странице выберите IP addresses (IP-адреса) и вставьте нужные IP-адреса серверов, после чего нажмите Save (Сохранить).

Как получить новый ключ API?

См. информацию о начале работы с платформой Google Карт.

Где найти список изменений для каждой из версий платформы Google Карт?

Информацию об изменениях для многих API Карт можно найти по следующим ссылкам:

Также вы можете проверить наличие ошибок в версиях платформы Google Карт и информацию об их устранении с помощью Системы отслеживания ошибок платформы Google Карт по адресу:

https://issuetracker.google.com/bookmark-groups/76561

Как асинхронно загрузить API на страницу после ее загрузки?

Просто укажите параметр обратного вызова при загрузке API. Более подробную информацию и образец кода можно найти в этом разделе документации по Maps JavaScript API.

Как изменить язык продуктов платформы Google Карт с английского на другой?

По умолчанию API пытается загрузить карты на языке пользователя (в зависимости от его местоположения и настроек браузера). Некоторые API позволяют явным образом указать язык при отправке запроса. Дополнительную информацию вы найдете в документации по каждому API:

Поддерживаемые языки

Google часто обновляет список поддерживаемых языков. Этот список не является полным и может изменяться.

Код языка	Язык	Код языка	Язык
af	Африкаанс	ja	Японский
sq	Албанский	kn	Каннада
am	Амхарский	kk	Казахский
ar	Арабский	km	Кхмерский
hy	Армянский	ko	Корейский
az	Азербайджанский	ky	Киргизский
eu	Баскский	lo	Лаосский
be	Белорусский	lv	Латышский
bn	Бенгальский	lt	Литовский
bs	Боснийский	mk	Македонский
bg	Болгарский	ms	Малайский
my	Бирманский	ml	Малаялам
ca	Каталанский	mr	Маратхи
zh	Китайский	mn	Монгольский
zh-CN	Китайский (упрощенный)	ne	Непальский
zh-HK	Китайский (Гонконг)	no	Норвежский
zh-TW	Китайский (традиционный)	pl	Польский
hr	Хорватский	pt	Португальский
cs	Чешский	pt-BR	Португальский (Бразилия)
da	Датский	pt-PT	Португальский (Португалия)
nl	Нидерландский	pa	Пенджабский
en	Английский	ro	Румынский
en-AU	Английский (Австралия)	ru	Русский
en-GB	Английский (Великобритания)	sr	Сербский (кириллица)
et	Эстонский	sr-Latn	Сербский (латиница)
fa	Фарси	si	Сингальский
fi	Финский	sk	Словацкий
fil	Филиппинский	sl	Словенский
fr	Французский	es	Испанский
fr-CA	Французский (Канада)	es-419	Испанский (Латинская Америка)
gl	Галисийский	sw	Суахили
ka	Грузинский	sv	Шведский
de	Немецкий	ta	Тамильский
el	Греческий	te	Телугу
gu	Гуджарати	th	Тайский
iw	Иврит	tr	Турецкий
hi	хинди	uk	Украинский
hu	Венгерский	ur	Урду
–	Исландский	uz	Узбекский
id	Индонезийский	vi	Вьетнамский
it	Итальянский	zu	Зулу

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

Можно ли обращаться к платформе Google Карт по протоколу HTTPS (TLS)?

Все API платформы Google Карт можно и нужно использовать через HTTPS. Чтобы обеспечить совместимость приложений с будущими технологиями, мы настоятельно рекомендуем использовать TLS 1.3 для HTTPS. Хотя более старые версии TLS по-прежнему поддерживаются, мы не рекомендуем использовать устаревшие версии TLS 1.0 и 1.1.

Устаревший протокол SSL больше не поддерживается.

Дополнительную информацию можно найти в часто задаваемых вопросах о переводе платформы Google Карт на корневой ЦС Google и часто задаваемых вопросах о Google Trust Services.

Как сообщить об ошибке или запросить новую функцию платформы Google Карт?

Если что-то работает не так, как ожидалось, рекомендуем сначала опубликовать сообщение на форуме. Это позволит другим разработчикам проверить, существует ли ошибка, и выявить возможные проблемы в вашем коде.

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

Убедившись, что вы обнаружили ошибку или что на платформе Google Карт нет нужной вам функции, отправьте запрос на добавление функции через Систему отслеживания ошибок платформы Google Карт.

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

Как API платформы Google Карт используют файлы cookie сайта?

Использование файлов cookie в Maps SDK для Android и Maps SDK для iOS регулируется Политикой конфиденциальности Google. Например, это влияет на такие действия, как расчет количества активных пользователей за день и семь дней и предотвращение злоупотребления сервисами. Эти файлы cookie не связаны ни с одним аккаунтом Google, в который выполнен вход, и, как и другая информация, полученная из вызовов API, не регистрируются в журналах.

Я не могу найти ответ на свой вопрос. Куда мне обратиться?

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

Обращаясь за помощью, следуйте этим рекомендациям:

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

Ошибки и устранение неполадок

Что означает эта ошибка?

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

Карты отображаются более темными, чем обычно. Что случилось?

При некоторых обстоятельствах карты могут отображаться затемненными, а изображения Просмотра улиц – в негативе, с водяными знаками с текстом For development purposes only (Только для целей разработки). Это обычно означает проблемы с ключом API или оплатой сервисов. Чтобы использовать продукты платформы Google Карт, нужен платежный аккаунт. Кроме того, все запросы должны содержать действующий ключ API. Выберите подходящие ответы на вопросы ниже и следуйте инструкциям.

Используете ли вы ключ API?

Не знаю. Как проверить, использую ли я ключ API?

Ключ API передается как параметр key в URL, который используется для загрузки Maps JavaScript API. Существует несколько способов проверить, используете ли вы ключ API:

Воспользуйтесь расширением Chrome Google Maps Platform API Checker. С его помощью вы сможете определить, правильно ли реализованы лицензионные Maps API на вашем сайте.
Если вы используете библиотеку или плагин для загрузки Maps JavaScript API, проверьте настройки этой библиотеки и найдите вариант с ключом API.
Проверьте, нет ли ошибок в вашем браузере. Если вы увидите следующие сообщения, значит вы неправильно используете ключ API:

Предупреждение Google Maps JavaScript API: NoApiKeys
Ошибка Google Maps JavaScript API: MissingKeyMapError

Для веб-разработчиков:

Если у вас есть доступ к коду приложения, найдите тег <script>, который используется для загрузки Maps JavaScript API. При загрузке Maps JavaScript API замените YOUR_API_KEY в указанном ниже коде ключом API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Проверьте в браузере сетевой трафик от вашего сайта. В Chrome это можно сделать с помощью вкладки Network (Сеть) в инструментах разработчика. Вы увидите сетевые запросы от вашего сайта. Запросы, сделанные с использованием Maps JavaScript API, будут указаны в пути maps/api/js. Здесь вы можете проверить, используется ли в запросах параметр key. Рекомендуем отфильтровать сетевой трафик на вкладке Network (Сеть) по пути maps/api/js.

Нет, я не использую ключ API.

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

Да, я использую ключ API.

Отлично! Проверьте, привязан ли к вашему проекту платежный аккаунт.

К вашему проекту привязан платежный аккаунт?

Не знаю. Как проверить, привязан ли к моему проекту платежный аккаунт?

Откройте страницу оплаты в консоли Google Cloud и выберите проект, в котором был создан ключ API. Чтобы подтвердить, что этот ключ связан с проектом, сделайте следующее:

Перейдите в раздел Credentials (Учетные данные). Для этого на боковой панели слева выберите Google Maps Platform > Credentials (Платформа Google Карт > Учетные данные).
Проверьте, есть ли в списке ключ API, который вы используете в настоящее время на своем сайте. Если его здесь нет, перейдите в другой проект и проверьте учетные данные там.
Если вы не можете найти проект для этого ключа, возможно, вы потеряли доступ к этому проекту. Попросите коллег о помощи. Если не получается найти исходный проект, можно сделать следующее:
1. Создайте новый проект. Для этого нажмите кнопку New Project (Новый проект) в списке проектов или Create Project (Создать проект) на странице Resource Manager (Менеджер ресурсов).
2. Создайте новый ключ API. Это можно сделать на странице Credentials (Учетные данные). После этого нажмите Create credentials (Создать учетные данные) и выберите API key (Ключ API).

После того как вы найдете свой проект в Cloud Console, выберите Billing (Оплата) в боковом меню слева и проверьте, связан ли с ним платежный аккаунт.

Нет, к моему проекту не привязан платежный аккаунт.

Откройте страницу включения оплаты в Cloud Console и добавьте к проекту платежный аккаунт. Дополнительные сведения можно найти в руководстве по началу работы с платформой Google Карт.

Да, к моему проекту привязан платежный аккаунт.

Отлично! Убедитесь, что вы указали действующий способ оплаты.

Указанный способ оплаты больше не действует (например, срок действия кредитной карты истек)?

Вы можете добавить, удалить или изменить способ оплаты в Cloud Console.

Установленный вами дневной лимит на использование API превышен?

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

Проверить дневные лимиты можно на странице APIs & Services Dashboard (API и сервисы) в Cloud Console. Сделайте следующее:

Если появится запрос, выберите проект.
Выберите API из списка и откройте вкладку Quotas (Квоты).

У вашего ключа API есть ограничение по IP-адресам?

Ключи API с ограничением по IP-адресам можно использовать только с веб-сервисами, которые предназначены для реализации на стороне сервера (например, Geocoding API и другие API веб-сервисов). Большинство этих веб-сервисов имеют аналоги в Maps JavaScript API (например, сервис геокодирования). Для использования Maps JavaScript API на стороне API-клиента вам нужно создать отдельный ключ API, который будет защищен ограничением по HTTP-реферерам. Подробная информация приведена в этой статье.

Как устранить ошибки с кодами OVER_DAILY_LIMIT и OVER_QUERY_LIMIT?

Ошибки с этими кодами могут возникнуть по одной из следующих причин:

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

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

Настройте платежный аккаунт.
Получите новый ключ API.
Скорректируйте установленное вами ограничение на использование, увеличив дневной лимит (если применимо).

Как устранить ошибки с кодами kGMSPlacesRateLimitExceeded и 9005 PLACES_API_RATE_LIMIT_EXCEEDED?

Если возникла ошибка с кодом kGMSPlacesRateLimitExceeded или 9005 PLACES_API_RATE_LIMIT_EXCEEDED, возможно, вы используете версию Places SDK для Android или Places SDK для iOS, поддержка которой прекращена. Подробную информацию и новые SDK можно найти по адресу https://goo.gle/places-sdk-deprecation.

Как устранить ошибку This IP, site or mobile application is not authorized to use this API key (Этот IP, сайт или мобильное приложение не авторизованы для использования этого ключа API)?

Эта ошибка могла возникнуть по следующим причинам:

Вы установили ограничение ключа API по IP-адресу (для сервера), а отправка запроса выполняется с неавторизованного IP-адреса.
Вы установили ограничение ключа API по заголовку HTTP referer (для сайтов), а запрос выполняется неавторизованным источником.
Вы разрешили использовать ключ API только для ваших приложений Android, задав имя пакета и цифровой отпечаток, а запрос выполняется из неавторизованного приложения Android.
Вы ограничили запросы из приложений iOS, указав идентификаторы пакетов, а отправить запрос пытается нераспознанное приложение iOS.
Раньше эта ошибка могла возникнуть, если вы использовали один из API веб-сервисов с ключом API, ограниченным по заголовку HTTP referer. Запросы к таким API должны содержать ключ API с ограничениями по IP-адресу. Измените тип ограничения ключа с заголовка HTTP referer на IP-адрес. Более подробная информация об ограничениях ключей API приведена в этой статье.

Просмотр и изменение учетных данных ключа API

Чтобы посмотреть свои ключи API и изменить ограничения, выполните следующие действия:

Откройте страницу Credentials (Учетные данные) в Cloud Console.
Выберите проект с нужным ключом API.
Чтобы посмотреть учетные данные, в том числе ограничения для ключа, в списке ключей API нажмите на название ключа.
Отобразятся полные учетные данные выбранного ключа API. Здесь можно удалять или изменять ограничения.

Как устранить ошибку API keys with referer restrictions cannot be used with this API (С этим API нельзя использовать ключи API с ограничениями по заголовку referer)?

Вы используете один из API веб-сервисов с ограничением ключа API по заголовку HTTP referer. Из соображений безопасности API веб-сервисов должны использовать ключи API с ограничениями по IP-адресам. Измените тип ограничения ключа с заголовка HTTP referer на IP-адрес или создайте новый ключ API, если ваш ключ уже используется в Maps JavaScript API.

Сервисы платформы Google Карт

Мне нужно преобразовать адреса в координаты (широту и долготу). Можно ли это сделать с помощью платформы Google Карт?

Да, этот процесс называется геокодированием. В Maps JavaScript API предусмотрен отдельный класс для выполнения геокодирования: google.maps.Geocoder.

Вы также можете воспользоваться Geocoding API от Google, который предоставляет интерфейс REST с поддержкой форматов JSON и XML.

В каких странах доступно геокодирование?

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

Точность геокодирования различается в разных странах, и ее можно определить с помощью параметра location_type, содержащегося в ответе на запрос. Доступ к данным геокодирования зависит от наших соглашений с поставщиками данных, которые могут измениться.

Почему геокодеры платформы Google Карт и Google Карты сообщают разное местоположение?

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

Как оформлять запросы к геокодеру, чтобы повысить вероятность их успешной обработки?

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

Указывайте адреса в формате, принятом для почтовых адресов в нужной вам стране.
Не указывайте дополнительные данные, обычно не содержащиеся в почтовых адресах этой страны, например названия компаний, номера этажей и квартир. Это может привести к получению ответов ZERO_RESULTS.
Коды Plus Code следует форматировать так, как в примере ниже (символы плюса экранируются в URL как %2B, а пробелы – как %20):
- Глобальный код содержит 4 знака кода зоны и 6 и более знаков местного кода (849VCWC8+R9 – это 849VCWC8%2BR9).
- Составной код содержит 6 и более знаков местного кода с точными данными о местоположении (CWC8+R9 для Маунтин-Вью, Калифорния, США, имеет значение CWC8%2BR9%20Mountain%20View%20CA%20USA).
По возможности указывайте номера домов, а не их названия.
По возможности указывайте номера домов, а не информацию о том, на пересечении каких улиц они находятся.
не добавляйте "подсказки" вроде названий местных ориентиров.

Какой формат должен иметь адрес нумерованной магистрали в США для геокодирования?

Для правильной работы геокодера платформы Google Карт нумерованные магистрали США необходимо указывать в следующих форматах:

Дороги местного значения: "Co Road NNN", где NNN – это номер дороги. Пример: "Co Road 82"
Дороги штата: "State NNN", где State – это полное название штата, а NNN – номер автомагистрали. Пример: "California 82"
Автомагистрали США: "US NNN", где NNN – номер автомагистрали. Пример: "US 101"
Дороги между штатами: "Interstate NNN", где NNN – это номер дороги. Пример: "Interstate 280"

Когда нужно использовать класс geocoder в API, а когда – HTTP-сервис геокодирования?

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

Как предоставить маршруты с помощью платформы Google Карт?

Сервис Compute Routes, включенный в Routes API, позволяет показывать маршруты с одним и несколькими пунктами назначения. Вы можете выбирать для схемы проезда режим передвижения (например, на автомобиле), один или несколько маршрутов и ограничения (например, без платных дорог). Этот сервис доступен в указанных ниже интерфейсах.

Интерфейс HTTP-запросов и ответов (используется в мобильных и других приложениях) совместим с Maps SDK для Android и другими веб-сервисами Google Карт.

В каких странах доступны схемы проезда?

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

В каких странах доступны маршруты на общественном транспорте?

Routes API поддерживает всех партнеров Google Транспорта, кроме Indian Railway Catering and Tourism Corporation и партнеров из Японии.

Какие функции KML и GeoRSS поддерживаются в Maps JavaScript API?

Класс KmlLayer в Maps JavaScript API позволяет разработчикам накладывать файлы KML/KMZ и GeoRSS поверх карты. Документацию и примеры можно найти на странице класса KmlLayer.

Каковы ограничения на размер и сложность объектов KML, которые можно загружать с помощью класса KmlLayer в Maps JavaScript API?

Ограничения на размер и сложность объектов KML, отображаемых с помощью класса KmlLayer, приведены в обзоре KmlLayer.

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

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

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

Какое максимальное количество маркеров или вершин пути поддерживается в Maps Static API?

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

Обратите внимание, что максимальная длина URL в Maps Static API составляет приблизительно 8192 символа, поэтому в запросе может содержаться ограниченное число маркеров и вершин пути. Оно зависит от того, сколько знаков после запятой указывается для каждой пары значений широты и долготы. Подробная информация о том, как количество знаков после запятой в географических координатах влияет на точность позиционирования, приведена в статье Википедии Decimal Degrees (на английском языке).

Почему в некоторых странах возникает проблема с доступом к продуктам платформы Google Карт?

Maps API нельзя использовать на запрещенных территориях. Подробная информация приведена в Условиях использования.

Как сообщить о проблеме на базовой карте Google?

В Google Картах можно сообщить о неверной или отсутствующей информации. Примеры:

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

Если речь идет о месте или компании, вы также можете предложить исправление.

Если какой-то контент Карт нарушает действующие законы и его следует удалить, отправьте официальный запрос.

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

Как отслеживать эффективность сервисов, для работы которых используется Maps JavaScript API?

В некоторых клиентских функциях есть инструменты, которые сообщают об успехе или неудаче. Это необходимо для расчета SLO (целевого показателя уровня обслуживания). С помощью соответствующих запросов в Google по адресу maps.googleapis.com/maps_api_js_slo/log отправляется следующая информация: статус успешного выполнения, время реакции и версия/канал Maps JavaScript API. Для повышения эффективности вызовы могут быть объединены. Вам может потребоваться разрешить maps.googleapis.com в Content Security Policy, чтобы эти вызовы не блокировались на уровне браузера. Примеры: Content-Security-Policy: default-src 'self' maps.googleapis.com; для HTTP-заголовков и <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> для метатегов HTML.

Maps JavaScript API

В течение какого времени после загрузки будет работать Maps JavaScript API?: Страницу, которая загружает Maps JavaScript API, нужно обновлять минимум раз в 5 дней.

Google Maps SDK для iOS

Как устранить ошибку kGMSPlacesRateLimitExceeded?

Если вы видите эту ошибку, возможно, вы используете устаревшую версию Places SDK для iOS. Версия 2.7.0 Places SDK для iOS отключена и более не доступна. Как можно скорее обновите свое приложение, чтобы перейти на последнюю версию. Подробную информацию об этом вы найдете в руководстве по переходу.

Попытки отладки с использованием устройства iOS 8.x завершаются ошибками. Что делать?

Если при отладке с использованием устройств iOS 8.x возникают ошибки, выполните приведенные ниже действия, чтобы отключить захват кадров графического процессора в схеме Xcode.

В Xcode выберите Product (Продукт), Scheme (Схема), Manage Schemes (Управление схемами).
Выберите схему и нажмите Edit…(Редактирование).
Установите для параметра GPU Frame Capture (Захват кадров графического процессора) значение Disabled (Отключено). Обратите внимание, что этот параметр может указываться не для всех устройств.

Параметр GPU Frame Capture на странице Generic iOS-устройства в Xcode.

Что изменилось в Google Maps SDK для iOS после выхода iPhone с закругленными углами и более широким разрешением экрана?

Начиная с модели iPhone X, у дисплеев iPhone закругленные углы, выемка для датчика в верхней части и индикатор для перехода на главный экран в нижней части. В SDK для iOS 11.0 специалисты Apple добавили Safe Area API, позволяющий разработчикам размещать элементы в области, которая не будет обрезаться новой формой экрана.

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

В версии 2.5 Google Maps SDK для iOS эти проблемы решаются автоматически. Если приложение используется на iPhone X или более поздней версии, поля GMSMapView и GMSPanoramaView увеличиваются так, чтобы визуальные элементы не обрезались.

По умолчанию мы всегда будем включать эти поля. В Google Maps SDK для iOS предполагается, что эти поля предназначены для обеспечения безопасной зоны. Если вы размещаете все элементы своего интерфейса в безопасной зоне, от вас не потребуется дополнительных действий.

Если вы разработали интерфейс, который не работает с нашими параметрами корректировки по умолчанию, воспользуйтесь новым свойством GMSMapView под названием paddingAdjustmentBehavior. В GMSMapView можно выбрать один из вариантов корректировки полей: Always (Всегда) (выбрано по умолчанию), Automatic (Автоматически) или Never (Никогда).

Если в GMSMapView для корректировки полей установлено значение Always (Всегда), то к полям всегда будет добавляться отступ безопасной зоны. Это позволит вам разрабатывать собственный интерфейс с уверенностью в том, что все элементы будут находиться в безопасной зоне. Это значение используется по умолчанию.

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

Если в GMSMapView для корректировки полей установлено значение Never (Никогда), к полям не будет добавляться отступ безопасной зоны. Он не использовался до выхода версии 2.5, и это удобно в тех случаях, когда поля заданы с учетом безопасной зоны или другие варианты не подходят для вашего интерфейса. Вы ответственны за то, чтобы логотип Google и информация об авторских правах всегда были видны, как описано в Условиях использования платформы Google Карт.

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

Google Maps SDK для Android

Как устранить ошибку с кодом 9005 PLACES_API_RATE_LIMIT_EXCEEDED?: Если вы видите эту ошибку, возможно, вы используете устаревшую версию Places SDK для Android. Версия Places SDK для Android для сервисов Google Play отключена и более не доступна. Как можно скорее обновите свое приложение, чтобы перейти на последнюю версию. Подробную информацию об этом вы найдете в руководстве по переходу.

В моем приложении вместо карты отображаются только пустые серые плитки. Что можно сделать?

Частой причиной того, что вместо карты отображаются пустые серые плитки, являются проблемы с аутентификацией. Их можно устранить с помощью adb logcat. Для этого сделайте следующее:

Убедитесь, что у вас установлен adb. В противном случае следуйте инструкциям по использованию Android Debug Bridge.
Установите приложение, которое показывает проблему, на устройство или эмулятор Android. Если вы используете эмулятор Android, убедитесь, что в его настройках включен Google Play.
В терминале Android Studio введите код adb logcat -e "Google Maps Android API". При этом будут выведены только те строки, в которых сообщение в журнале соответствует Google Maps Android API (в качестве опции вы можете вывести журнал в текстовый файл, добавив: > logcat.txt).
Воспроизведите проблему на своем устройстве и проверьте, нет ли следующих распространенных ошибок:

В файле манифеста указан неправильный/неподходящий ключ API.
Платежные функции в проекте отключены.
SDK в API проекта отключены.
К ограничениям ключа API добавлен неверный цифровой отпечаток SHA-1.
Зависимости сервисов Google Play не включены в файл build.gradle.

Требуется ли аппаратное ускорение для Google Maps SDK для Android?: Да, чтобы избежать проблем с загрузкой карт, в файле AndroidManifest.xml приложения необходимо задать для параметра hardwareAccelerated значение true.
Дополнительную информацию можно найти на странице Аппаратное ускорение в документации для разработчиков Android.

Подпись URL

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

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

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

Ошибка HTTP 403 означает проблемы с разрешениями доступа, вероятно вызванные тем, что невозможно подтвердить подпись для запроса. Возможные причины:

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

Часто задаваемые вопросы о платформе Google Карт Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Условия использования

Тарификация и лимиты на использование (квоты)

Как использовать платформу Google Карт

Ошибки и устранение неполадок

Сервисы платформы Google Карт

Maps JavaScript API

Google Maps SDK для iOS

Google Maps SDK для Android

Подпись URL

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

Условия использования

Тарификация и лимиты на использование

Как использовать платформу Google Карт

Ошибки и устранение неполадок

Используете ли вы ключ API?

Не знаю. Как проверить, использую ли я ключ API?

Для веб-разработчиков:

Нет, я не использую ключ API.

Да, я использую ключ API.

К вашему проекту привязан платежный аккаунт?

Не знаю. Как проверить, привязан ли к моему проекту платежный аккаунт?

Нет, к моему проекту не привязан платежный аккаунт.

Да, к моему проекту привязан платежный аккаунт.

Указанный способ оплаты больше не действует (например, срок действия кредитной карты истек)?

Установленный вами дневной лимит на использование API превышен?

У вашего ключа API есть ограничение по IP-адресам?

Сервисы платформы Google Карт

Maps JavaScript API

Google Maps SDK для iOS

Google Maps SDK для Android

Подпись URL

Часто задаваемые вопросы о платформе Google Карт