Примечание:

Используйте ScribbleMaps Connect Picker, когда вы хотите, чтобы пользователи входили в Scribble Maps, просматривали свои доступные карты и возвращали данные карт непосредственно в ваше веб-приложение.

 

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

Содержание

Как работает Connect Picker

ScribbleMaps Connect Picker позволяет вашим пользователям просматривать, искать и выбирать карты из Scribble Maps, а затем возвращать эти данные карт непосредственно в ваше приложение в выбранном вами формате.

Это полезно, когда вы хотите, чтобы пользователи создавали геоданные или управляли ими в Scribble Maps, а затем загружали эти данные в ваше собственное приложение без создания собственного браузера карт или процесса входа в систему.

Вариант использования / Пример:

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

Посмотреть содержание ↑

Получение Client ID

1. Откройте сайт для разработчиков Scribble Maps:
   https://developers.scribblemaps.com

    

2. Зарегистрируйте бесплатный проект.

    

3. Скопируйте ваш Client ID.

   Вы будете использовать это значение при вызове Connect Picker.

Посмотреть содержание ↑

Добавление SDK на страницу

1. Добавьте Connect Picker SDK на свою веб-страницу:

   <script src="https://api.scribblemaps.com/connect/picker.js"></script>

    

2. Сохраните изменения на странице.

   Теперь Scribble Maps Connect Picker доступен для вашего приложения.

Посмотреть содержание ↑

Открытие Connect Picker

1. Вызовите ScribbleMapsConnect.pick() со своей страницы.

    

2. Передайте ваш clientId, желаемый format экспорта и функцию обратного вызова onSelect.

    

3. Используйте код, похожий на следующий пример:

   ScribbleMapsConnect.pick({
     clientId: 'YOUR_CLIENT_ID',
     format: 'geojson',
     onSelect: function (result) {
       // result.data содержит ваш GeoJSON
       // result.title, result.mapCode, result.thumbUrl также доступны
       loadIntoMyApp(result.data);
     }
   });

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

Посмотреть содержание ↑

Обработка данных выбранной карты

1. В обратном вызове onSelect обратитесь к result.data.

   Оно содержит данные карты в запрошенном вами формате.
    

2. (Необязательно) Используйте дополнительные возвращаемые поля:

   • result.title — название карты
   • result.mapCode — код карты Scribble Maps
   • result.thumbUrl — URL-адрес миниатюры карты
    

3. Передайте данные в логику вашего приложения.

   Например, загрузите возвращенный GeoJSON в собственный просмотрщик карт или рабочий процесс обработки данных.

Посмотреть содержание ↑

Дополнительная конфигурация

Вы можете настроить средство выбора, чтобы оно лучше соответствовало рабочему процессу вашего приложения.

1. Выберите формат экспорта, изменив значение format.

   Например: geojson, kml, csv, gpx, dxf, shapefile или smjson.
    

2. Выберите, какие источники карт могут просматривать пользователи с помощью опции tabs.

   Пользователи могут просматривать карты из своей личной библиотеки (personal library), карт совместного использования команды (team-shared maps) или коллекции сообщества (community collection).
    
3. (Необязательно) Используйте встроенные стили кнопок для соответствия светлому (light) или темному (dark) интерфейсу.

Посмотреть содержание ↑

Поддерживаемые форматы и возвращаемые поля

Поддерживаемые форматы экспорта:

• GeoJSON
• KML
• CSV
• GPX
• DXF
• Shapefile
• SMJSON

Возвращаемые поля результатов:

• data
• title
• mapCode
• thumbUrl

После настройки Connect Picker предоставляет вашим пользователям доступ к их данным Scribble Maps непосредственно из вашего приложения через единую точку интеграции.

Связанные статьи

Scribble Maps Developers

Scribble Maps Connect Picker

Импорт/экспорт файлов и данных - GeoJSON, изображения, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT и т. д.

Импорт/экспорт: описания, примеры, ограничения и обходные пути - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP