Hinweis:

Verwenden Sie den ScribbleMaps Connect Picker, wenn Sie möchten, dass sich Benutzer bei Scribble Maps anmelden, ihre verfügbaren Karten durchsuchen und Kartendaten direkt an Ihre Webanwendung zurückgeben.

 

Der Picker öffnet sich in einem Popup und wickelt dort den Anmeldevorgang des Benutzers ab, sodass Ihre Anwendung Scribble Maps-Anmeldedaten nicht direkt erfassen muss.

Inhalt

Wie der Connect Picker funktioniert

Der ScribbleMaps Connect Picker ermöglicht es Ihren Benutzern, Karten in Scribble Maps zu durchsuchen, zu suchen und auszuwählen und diese Kartendaten dann direkt in dem von Ihnen gewählten Format an Ihre Anwendung zurückzugeben.

Dies ist nützlich, wenn Sie möchten, dass Benutzer Geodaten in Scribble Maps erstellen oder verwalten und diese Daten dann in Ihre eigene App laden, ohne einen eigenen Karten-Browser oder Anmelde-Flow erstellen zu müssen.

Anwendungsfall / Beispiel:

Diese Integration ist nützlich für Dashboards, Immobilien-Tools, Felddaten-Anwendungen und andere Web-Apps, bei denen Benutzer kartierte Daten aus Scribble Maps auswählen und laden müssen.

Inhalt anzeigen ↑

Holen Sie sich Ihre Client-ID

1. Öffnen Sie die Entwickler-Website von Scribble Maps:
   https://developers.scribblemaps.com

    

2. Registrieren Sie ein kostenloses Projekt.

    

3. Kopieren Sie Ihre Client-ID.

   Sie verwenden diesen Wert, wenn Sie den Connect Picker aufrufen.

Inhalt anzeigen ↑

Fügen Sie das SDK zu Ihrer Seite hinzu

1. Fügen Sie auf Ihrer Webseite das Connect Picker SDK hinzu:

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

    

2. Speichern Sie Ihre Änderungen an der Seite.

   Der Scribble Maps Connect Picker ist nun für Ihre Anwendung verfügbar.

Inhalt anzeigen ↑

Öffnen Sie den Connect Picker

1. Rufen Sie ScribbleMapsConnect.pick() von Ihrer Seite aus auf.

    

2. Übergeben Sie Ihre clientId, das gewünschte Export-format und einen onSelect-Callback.

    

3. Verwenden Sie Code ähnlich dem folgenden Beispiel:

   ScribbleMapsConnect.pick({
     clientId: 'YOUR_CLIENT_ID',
     format: 'geojson',
     onSelect: function (result) {
       // result.data enthält Ihr GeoJSON
       // result.title, result.mapCode, result.thumbUrl ebenfalls verfügbar
       loadIntoMyApp(result.data);
     }
   });

   Wenn sich der Picker öffnet, kann sich der Benutzer authentifizieren, seine verfügbaren Karten durchsuchen und eine auswählen.

Inhalt anzeigen ↑

Verarbeiten Sie die ausgewählten Kartendaten

1. Greifen Sie im onSelect-Callback auf result.data zu.

   Dies enthält die Kartendaten in dem von Ihnen angeforderten Format.
    

2. (Optional) Verwenden Sie die zusätzlichen zurückgegebenen Felder:

   • result.title — der Kartentitel
   • result.mapCode — der Scribble Maps-Kartencode
   • result.thumbUrl — eine Thumbnail-URL für die Karte
    

3. Übergeben Sie die Daten an Ihre Anwendungslogik.

   Laden Sie beispielsweise das zurückgegebene GeoJSON in Ihren eigenen Karten-Viewer oder Daten-Workflow.

Inhalt anzeigen ↑

Optionale Konfiguration

Sie können den Picker so konfigurieren, dass er besser zu Ihrem Anwendungs-Workflow passt.

1. Wählen Sie das Exportformat, indem Sie den Wert für format ändern.

   Zum Beispiel: geojson, kml, csv, gpx, dxf, shapefile oder smjson.
    

2. Wählen Sie mit der Option tabs aus, welche Kartenquellen Benutzer durchsuchen können.

   Benutzer können Karten aus ihrer persönlichen Bibliothek, für das Team freigegebenen Karten oder der Community-Sammlung durchsuchen.
    
3. (Optional) Verwenden Sie die enthaltenen Schaltflächenstile, um sie an eine helle oder dunkle Benutzeroberfläche anzupassen.

Inhalt anzeigen ↑

Unterstützte Formate und zurückgegebene Felder

Unterstützte Exportformate:

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

Zurückgegebene Ergebnisfelder:

• data
• title
• mapCode
• thumbUrl

Nach der Konfiguration ermöglicht der Connect Picker Ihren Benutzern den direkten Zugriff auf ihre Scribble Maps-Daten aus Ihrer Anwendung heraus über einen einzigen Integrationspunkt.

Zugehörig

Scribble Maps Developers

Scribble Maps Connect Picker

Dateien & Daten importieren/exportieren - GeoJSON, Bilder, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT usw.

Import/Export: Beschreibungen, Beispiele, Einschränkungen und Workarounds - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP