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

КраткоКарты в приложении бесплатно работают и без Mapbox. Вставьте публичный токен Mapbox (pk.…) в разделе «Облачные сервисы» → «Облако», и карты улиц сами перейдут на стили Mapbox, включая спутниковые. Попросите MonstarX добавить поиск адресов или маршруты — он воспользуется тем же токеном.

Карты в собственном стиле, геокодирование и маршруты.

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

Mapbox — картографическая компания, известная красивыми стилями карт и спутниковыми снимками. Любое приложение MonstarX и так бесплатно показывает карту улиц (см. статью Карты в приложении без ключа API). Подключение Mapbox улучшает эти карты и добавляет поиск адресов и маршруты.

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

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

Что изменится после подключения?

Карты улиц в приложении сами переходят на стили Mapbox, как только токен добавлен, — пересоздавать ничего не нужно. Карта, которую MonstarX сделал в спутниковом стиле, с этого момента показывает настоящие спутниковые снимки. А вот поиск адресов и маршруты нужно попросить отдельно: это новые функции.

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

Аккаунт Mapbox. Каждый месяц Mapbox бесплатно даёт определённый объём загрузок карт и запросов, а сверх него вы платите за использование (см. цены Mapbox).

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

Войдите в Mapbox и откройте Access tokens.
Скопируйте Default public token или нажмите Create a token, чтобы создать отдельный токен для этого приложения. Публичные токены начинаются с pk..

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

Откройте проект, нажмите Облачные сервисы на верхней панели, затем Облако.
В разделе Подключения нажмите Подключить рядом с Mapbox.
Вставьте токен в поле Токен публичного доступа.
Нажмите Подключить Mapbox. В строке появится Подключено, предпросмотр перезапустится, и карты в нём будут в стилях Mapbox.

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

Вы пишете	Что происходит
«Покажи карту объектов в спутниковом режиме.»	Карта переходит на спутниковые снимки Mapbox.
«Когда человек вводит адрес при регистрации, показывай его меткой на карте.»	Адрес ищется один раз, сохраняется вместе с координатами и отмечается на карте.
«Покажи маршрут на машине и время в пути от студии до адреса участника.»	Маршрут на карте с расстоянием и временем в минутах.
«Используй для карт тёмный стиль Mapbox.»	Все карты переходят на тёмный стиль.

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

Это публичный токен: он рассчитан на работу в браузере, поэтому его не прячут. Изменить ваш аккаунт Mapbox с его помощью нельзя.
Токен хранится только вместе с этим приложением, и приложение отправляет его только в Mapbox.
Подключить, обновить или отключить Mapbox может только владелец проекта. После нажатия Отключить карты возвращаются к бесплатной карте MonstarX, а поиск адресов и маршруты перестают работать.
Чтобы заменить токен, создайте новый, нажмите Обновить ключи в строке Mapbox, вставьте его и нажмите Сохранить ключи. Опубликуйте приложение заново, а потом удалите старый токен.

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

Используйте публичный токен (pk.). Секретные токены (sk.) нужны для управления аккаунтом Mapbox, в приложении им не место.
Каждая загрузка карты и каждый запрос учитываются в использовании Mapbox, в том числе в предпросмотре.
Для поиска мест, сведений об организациях и отзывов лучше подходит Google Maps — там больше данных.

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

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

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

Нужно ли пересоздавать карты после подключения?

Нет. Карты улиц сами переходят на стили Mapbox, как только токен сохранён.

Почему карты перестали загружаться, после того как я ограничил токен?

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

Безопасно ли держать токен в браузере?

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