Uwaga:

Użyj ScribbleMaps Connect Picker, gdy chcesz, aby użytkownicy logowali się do Scribble Maps, przeglądali swoje dostępne mapy i zwracali dane map bezpośrednio do Twojej aplikacji internetowej.

 

Selektor otwiera się w wyskakującym oknie i tam obsługuje proces logowania użytkownika, dzięki czemu Twoja aplikacja nie musi bezpośrednio zbierać danych uwierzytelniających Scribble Maps.

Spis treści

Jak działa Connect Picker

ScribbleMaps Connect Picker pozwala użytkownikom przeglądać, wyszukiwać i wybierać mapy ze Scribble Maps, a następnie zwracać te dane map bezpośrednio do Twojej aplikacji w wybranym formacie.

Jest to przydatne, gdy chcesz, aby użytkownicy tworzyli geodane lub zarządzali nimi w Scribble Maps, a następnie ładowali te dane do Twojej własnej aplikacji bez konieczności budowania własnej przeglądarki map lub przepływu logowania.

Przypadek użycia / Przykład:

Ta integracja jest przydatna w przypadku pulpitów nawigacyjnych, narzędzi do obsługi nieruchomości, aplikacji do zbierania danych w terenie i innych aplikacji internetowych, które wymagają od użytkowników wyboru i ładowania zmapowanych danych ze Scribble Maps.

Wyświetl spis treści ↑

Pobierz swój Client ID

1. Otwórz stronę dla deweloperów Scribble Maps:
   https://developers.scribblemaps.com

    

2. Zarejestruj bezpłatny projekt.

    

3. Skopiuj swój Client ID.

   Użyjesz tej wartości podczas wywoływania Connect Picker.

Wyświetl spis treści ↑

Dodaj SDK do swojej strony

1. Na swojej stronie internetowej dodaj SDK Connect Picker:

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

    

2. Zapisz zmiany na stronie.

   Scribble Maps Connect Picker jest teraz dostępny dla Twojej aplikacji.

Wyświetl spis treści ↑

Otwórz Connect Picker

1. Wywołaj ScribbleMapsConnect.pick() ze swojej strony.

    

2. Przekaż swój clientId, żądany format eksportu oraz funkcję zwrotną onSelect.

    

3. Użyj kodu podobnego do poniższego przykładu:

   ScribbleMapsConnect.pick({
     clientId: 'YOUR_CLIENT_ID',
     format: 'geojson',
     onSelect: function (result) {
       // result.data zawiera Twój GeoJSON
       // result.title, result.mapCode, result.thumbUrl są również dostępne
       loadIntoMyApp(result.data);
     }
   });

   Po otwarciu selektora użytkownik może się uwierzytelnić, przeglądać swoje dostępne mapy i wybrać jedną z nich.

Wyświetl spis treści ↑

Obsłuż wybrane dane mapy

1. W funkcji zwrotnej onSelect uzyskaj dostęp do result.data.

   Zawiera on dane mapy w żądanym formacie.
    

2. (Opcjonalnie) Użyj dodatkowych zwróconych pól:

   • result.title — tytuł mapy
   • result.mapCode — kod mapy Scribble Maps
   • result.thumbUrl — adres URL miniatury mapy
    

3. Przekaż dane do logiki swojej aplikacji.

   Na przykład załaduj zwrócony GeoJSON do własnej przeglądarki map lub przepływu pracy z danymi.

Wyświetl spis treści ↑

Opcjonalna konfiguracja

Możesz skonfigurować selektor, aby lepiej dopasować go do przepływu pracy Twojej aplikacji.

1. Wybierz format eksportu, zmieniając wartość format.

   Na przykład: geojson, kml, csv, gpx, dxf, shapefile lub smjson.
    

2. Wybierz, które źródła map mogą przeglądać użytkownicy za pomocą opcji tabs.

   Użytkownicy mogą przeglądać mapy ze swojej biblioteki osobistej, map udostępnionych zespołowi lub kolekcji społeczności.
    
3. (Opcjonalnie) Użyj dołączonych stylów przycisków, aby dopasować je do jasnego lub ciemnego interfejsu.

Wyświetl spis treści ↑

Obsługiwane formaty i zwracane pola

Obsługiwane formaty eksportu:

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

Zwracane pola wyników:

• data
• title
• mapCode
• thumbUrl

Po skonfigurowaniu Connect Picker zapewnia użytkownikom dostęp do ich danych Scribble Maps bezpośrednio z poziomu Twojej aplikacji za pośrednictwem jednego punktu integracji.

Powiązane

Scribble Maps Developers

Scribble Maps Connect Picker

Import/Eksport plików i danych - GeoJSON, obrazy, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT itp.

Import/Eksport: Opisy, przykłady, ograniczenia i obejścia - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP