შენიშვნა:

გამოიყენეთ ScribbleMaps Connect Picker, როდესაც გსურთ, მომხმარებლებმა შეხვიდნენ Scribble Maps-ში, დაათვალიერონ თავიანთი ხელმისაწვდომი რუკები და რუკის მონაცემები პირდაპირ თქვენს ვებ აპლიკაციას დაუბრუნონ.

 

Picker იხსნება ამომხტარ ფანჯარაში და იქვე ასრულებს მომხმარებლის ავტორიზაციას, ამიტომ თქვენს აპლიკაციას არ სჭირდება 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 contains your GeoJSON
       // result.title, result.mapCode, result.thumbUrl also available
       loadIntoMyApp(result.data);
     }
   });

   როდესაც picker იხსნება, მომხმარებელს შეუძლია ავტორიზაცია გაიაროს, დაათვალიეროს თავისი ხელმისაწვდომი რუკები და აირჩიოს ერთ-ერთი.

სარჩევის ნახვა ↑

დაამუშავეთ არჩეული რუკის მონაცემები

1. onSelect გამოძახების ფუნქციაში მიმართეთ result.data-ს.

   ის შეიცავს რუკის მონაცემებს თქვენ მიერ მოთხოვნილ ფორმატში.
    

2. (არასავალდებულო) გამოიყენეთ დაბრუნებული დამატებითი ველები:

   • result.title — რუკის სათაური
   • result.mapCode — Scribble Maps-ის რუკის კოდი
   • result.thumbUrl — რუკის მინიატურის URL
    

3. გადასცით მონაცემები თქვენი აპლიკაციის ლოგიკას.

   მაგალითად, ჩატვირთეთ დაბრუნებული GeoJSON თქვენს რუკის ნახვის ხელსაწყოში ან მონაცემთა სამუშაო პროცესში.

სარჩევის ნახვა ↑

არასავალდებულო კონფიგურაცია

შეგიძლიათ picker მოარგოთ თქვენი აპლიკაციის სამუშაო პროცესს.

1. აირჩიეთ ექსპორტის ფორმატი format მნიშვნელობის შეცვლით.

   მაგალითად: geojson, kml, csv, gpx, dxf, shapefile ან smjson.
    

2. აირჩიეთ, რომელი რუკების წყაროების დათვალიერება შეეძლოთ მომხმარებლებს tabs პარამეტრით.

   მომხმარებლებს შეუძლიათ რუკების დათვალიერება თავიანთი პირადი ბიბლიოთეკიდან, გუნდთან გაზიარებული რუკებიდან ან საზოგადოების კოლექციიდან.
    
3. (არასავალდებულო) გამოიყენეთ ჩართული ღილაკების სტილები, რათა მოარგოთ ღია ან მუქი ინტერფეისს.

სარჩევის ნახვა ↑

მხარდაჭერილი ფორმატები და დაბრუნებული ველები

მხარდაჭერილი ექსპორტის ფორმატები:

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

დაბრუნებული შედეგის ველები:

• data
• title
• mapCode
• thumbUrl

კონფიგურაციის დასრულების შემდეგ, Connect Picker თქვენს მომხმარებლებს საშუალებას აძლევს, თქვენი აპლიკაციის შიგნიდანვე, ერთი ინტეგრაციის წერტილის მეშვეობით მიიღონ წვდომა თავიანთ Scribble Maps-ის მონაცემებზე.

დაკავშირებული

Scribble Maps დეველოპერები

Scribble Maps Connect Picker

ფაილებისა და მონაცემების იმპორტი/ექსპორტი - GeoJSON, სურათები, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT და სხვ.

იმპორტი/ექსპორტი: აღწერები, მაგალითები, შეზღუდვები და გამოსავლები - CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP