React Native SDK

React Native SDK позволяет добавить карту 2ГИС в ваше приложение на платформе React Native. С помощью SDK можно отобразить карту на экране, получать информацию об объектах карты, строить маршруты, использовать навигатор и работать с офлайн-данными.

Примеры использования SDK см. в разделе Примеры.

Картографические данные поддерживают стандарты OGC.

Вы можете использовать React Native SDK на устройствах с операционными системами iOS и Android.

предупреждение

Текущая версия 14.0.0 является предварительной. API может изменяться без обратной совместимости в будущих минорных релизах 14.x.

Версии SDK

Пакет React Native SDK в первом релизе доступен в версии Map (@2gis/dgis-mobile-sdk-map) — облегчённая версия, которая позволяет:

• Добавлять карту в приложение и управлять ей: добавлять маркеры и геометрические фигуры, управлять движением камеры, отображать слои, работать со стилевыми атрибутами карты и т. д.
• Искать объекты в справочнике: организации, здания, места и другие.

Версия Full, которая позволяет работать с навигацией и оффлайн-данными, появится в будущих релизах.

API для работы SDK

В зависимости от нужных функциональностей, для работы SDK требуются ключи доступа к API карт, поиска и навигации. Доступные возможности зависят от версии SDK: Full или Map.

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

Карта

Подробнее о доступных возможностях см. в инструкции Карта.

Функциональность	API
Создание карты в приложении (компонент MapView, классы MapController и MapControllerOptions)	Map Tiles API Regions API
Отображение пробок на карте (класс TrafficSource)	Regions API
Отображение поэтажных планов зданий (класс IndoorManager)	Places API (доступ к планам этажей предоставляется по запросу и за дополнительную плату)

Справочник

Подробнее о доступных возможностях см. в инструкции Справочник.

Функциональность	API
Создание поискового движка (класс SearchManager)	Regions API
Получение результатов поиска (метод SearchManager.search())	Places API Markers API Получение некоторой информации об объектах доступно только при дополнительной настройке ключа за отдельную плату: см. раздел Структура данных объекта.
Поиск объектов в справочнике по идентификатору (методы SearchManager.searchByIds() и SearchManager.searchByDirectoryObjectIds())	Places API Markers API
Формирование поисковых подсказок (метод SearchManager.suggest())	Suggest API

Требования к устройствам

iOS 16 и выше / iPadOS 16 и выше.

Варианты размещения

• Облако: React Native SDK доступен для работы в облачной инфраструктуре 2ГИС.
• On-Premise: доступность React Native SDK при установке API-платформы 2ГИС в закрытом контуре зависит от версии React Native SDK и набора включённых сервисов API-платформы.

Подробнее см. в разделе API-платформа для сервера.

Помощь

• Если у вас возникли вопросы при работе с React Native SDK, задайте их AI-ассистенту (в правом нижнем углу сайта), воспользуйтесь поиском по документации или отправьте электронное письмо на api@2gis.ru.

• Если вы хотите обсудить возможности React Native SDK или его интеграцию с вашим продуктом, обратитесь к менеджеру.