Подключите Google Maps к приложению MonstarX

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

Карты Google, поиск мест и маршруты.

Тип: Для вашего приложения
Категория: Карты и места
Как подключить: Ключ API

Google Maps Platform — сервис Google с картографическими данными: места, адреса, часы работы, отзывы и маршруты, на которых построены Google Карты. Подключите его, и приложение сможет искать информацию в этих данных.

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

Что можно с этим создать?

Автозаполнение адреса: человек начинает вводить адрес и выбирает его из подсказок Google.
Поиск мест: «кафе рядом», «физиотерапевты в Хамовниках» — списком и на карте.
Сведения об организации: часы работы, телефон, рейтинг и отзывы.
Адреса на карте: введённый адрес превращается в метку (это называется геокодированием).
Маршруты на машине между двумя точками.

Что понадобится

Аккаунт Google Cloud с привязанным платёжным аккаунтом. Google Maps Platform требует его, даже если вы не выходите за бесплатный месячный объём (см. цены Google).
Проект Google Cloud для приложения.

Получите ключ

В консоли Google Cloud выберите или создайте проект и откройте Google Maps Platform.
Включите API, которые будет использовать приложение. Для идей выше: Maps JavaScript API и Places API (New) для поиска и автозаполнения, Geocoding API для адресов и Routes API для маршрутов.
Откройте раздел Ключи и учётные данные (Keys & Credentials) и создайте ключ API. Скопируйте его (он начинается с AIza).
Ограничьте ключ. В разделе Ограничения API (API restrictions) разрешите только те API, которые вы включили.

Этот ключ попадает в браузер, поэтому скопировать его может кто угодно. Ограничение по API не даёт использовать его ни для чего другого. Google также позволяет ограничить ключ адресами вашего сайта — но тогда Google будет отклонять запросы, которые приложение делает со своего сервера, например превращение адреса в точку на карте. Если приложению нужны такие запросы, ограничивайте ключ только по API или попросите MonstarX использовать для сервера второй ключ.

Подключите ключ в MonstarX

Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.
В разделе Подключения нажмите Подключить рядом с Google Maps.
Вставьте ключ в поле Ключ API.
Нажмите Подключить Google Maps. В строке появится Подключено, и предпросмотр перезапустится уже с ключом.

Как попросить MonstarX

Вы пишете	Что происходит
«В форме записи сделай автозаполнение адреса через Google Maps.»	Подсказки появляются по мере ввода; выбранный адрес сохраняется.
«Добавь страницу „Найдите студию рядом“ с поиском через Google Places.»	Поле поиска и результаты с названиями, адресами и рейтингами, отмеченные на карте.
«Покажи часы работы и рейтинг каждого кафе из Google.»	Сведения об организации из Google для каждого места.
«Покажи водителям маршрут от склада до каждого адреса доставки.»	Маршрут с расстоянием и временем в пути.

Безопасность и конфиденциальность

Это публичный ключ: он используется в браузерах людей, поэтому не скрыт. Защищают его ограничения, которые вы задаёте в Google Cloud.
Ключ хранится только в этом приложении. Его название видно в разделе Облачные сервисыСекреты.
Подключить, обновить или отключить Google Maps может только владелец проекта.
Чтобы заменить ключ, создайте новый в Google Cloud, нажмите Обновить ключи в строке Google Maps, вставьте его и нажмите Сохранить ключи. Опубликуйте приложение заново, а потом удалите старый ключ.

Полезно знать

Карты сохраняют свой вид: Google Maps добавляет в приложение данные и поиск, а не картографические плитки Google.
Сверх бесплатного месячного объёма Google берёт плату за каждый запрос. Настройте оповещение о бюджете в разделе оплаты Google Cloud.
Нужны спутниковые снимки или стили карт Mapbox? См. Mapbox.
В условиях Google есть правила показа данных о местах, например указывать Google как источник рядом с результатами. Если приложение показывает список мест, попросите MonstarX добавить эту подпись.

Вопросы и ответы

Нужен ли Google Maps, чтобы показать карту?

Нет. Любое приложение MonstarX бесплатно и без ключа показывает карты. Подключайте Google Maps, только если нужны места, автозаполнение, сведения об организациях или маршруты.

Почему Google пишет, что API не включён?

Каждый сервис Google Maps нужно включить в вашем проекте Google Cloud. Включите тот, что назван в ошибке, например Places API (New).

Это безопасно, что ключ есть в браузере?

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

Google Maps или Mapbox?

Google Maps — для мест, сведений об организациях и отзывов. Mapbox — для собственных стилей карт и спутниковых снимков. Оба умеют превращать адреса в метки и строить маршруты.