Ghi chú:

Dùng ScribbleMaps Connect Picker khi bạn muốn người dùng đăng nhập Scribble Maps, duyệt các bản đồ có sẵn và trả dữ liệu bản đồ trực tiếp về ứng dụng web của bạn.

 

Bộ chọn mở trong cửa sổ bật lên và xử lý đăng nhập tại đó, nên ứng dụng của bạn không cần trực tiếp thu thập thông tin đăng nhập Scribble Maps.

Mục lục

Cách Connect Picker hoạt động

Bộ chọn ScribbleMaps Connect Picker cho phép người dùng duyệt, tìm kiếm và chọn bản đồ từ Scribble Maps, rồi trả dữ liệu bản đồ trực tiếp về ứng dụng của bạn theo định dạng bạn chọn.

Tính năng này hữu ích khi bạn muốn người dùng tạo hoặc quản lý dữ liệu địa lý trong Scribble Maps rồi tải vào ứng dụng của mình mà không cần tự xây dựng trình duyệt bản đồ hoặc luồng đăng nhập.

Trường hợp sử dụng / Ví dụ:

Tích hợp này hữu ích cho bảng điều khiển, công cụ bất động sản, ứng dụng dữ liệu thực địa và ứng dụng web khác cần người dùng chọn rồi tải dữ liệu bản đồ từ Scribble Maps.

Xem mục lục ↑

Lấy Client ID của bạn

1. Mở trang nhà phát triển Scribble Maps:
   https://developers.scribblemaps.com

    

2. Đăng ký dự án miễn phí.

    

3. Sao chép Client ID.

   Bạn sẽ dùng giá trị này khi gọi Connect Picker.

Xem mục lục ↑

Thêm SDK vào trang

1. Trong trang web, thêm SDK Connect Picker:

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

    

2. Lưu thay đổi của trang.

   Ứng dụng của bạn hiện đã có Scribble Maps Connect Picker.

Xem mục lục ↑

Mở Connect Picker

1. Gọi ScribbleMapsConnect.pick() từ trang của bạn.

    

2. Truyền clientId, định dạng xuất format bạn muốn và hàm gọi lại onSelect .

    

3. Dùng mã tương tự ví dụ sau:

   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);
     }
   });

   Khi bộ chọn mở, người dùng có thể xác thực, duyệt các bản đồ có sẵn và chọn một bản đồ.

Xem mục lục ↑

Xử lý dữ liệu bản đồ đã chọn

1. Trong hàm gọi lại onSelect , truy cập result.data.

   Trường này chứa dữ liệu bản đồ theo định dạng bạn yêu cầu.
    

2. (Tùy chọn) Dùng các trường bổ sung được trả về:

   • result.title – tiêu đề bản đồ
   • result.mapCode – mã bản đồ Scribble Maps
   • result.thumbUrl – URL ảnh thu nhỏ của bản đồ
    

3. Truyền dữ liệu vào logic ứng dụng của bạn.

   Ví dụ, tải GeoJSON được trả về vào trình xem bản đồ hoặc quy trình dữ liệu của bạn.

Xem mục lục ↑

Cấu hình tùy chọn

Bạn có thể cấu hình bộ chọn để phù hợp hơn với quy trình ứng dụng.

1. Chọn định dạng xuất bằng cách thay đổi giá trị format .

   Ví dụ: geojson, kml, csv, gpx, dxf, shapefilehoặc smjson.
    

2. Chọn nguồn bản đồ người dùng có thể duyệt bằng tùy chọn tabs .

   Người dùng có thể duyệt bản đồ từ thư viện cá nhân, bản đồ được nhóm chia sẻhoặc bộ sưu tập cộng đồng.
    
3. (Tùy chọn) Dùng các kiểu nút đi kèm để phù hợp với giao diện sáng hoặc tối .

Xem mục lục ↑

Định dạng hỗ trợ và trường trả về

Các định dạng xuất được hỗ trợ:

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

Các trường kết quả trả về:

• data
• tiêu đề
• mapCode
• thumbUrl

Sau khi cấu hình, Connect Picker cho phép người dùng truy cập dữ liệu Scribble Maps ngay trong ứng dụng của bạn thông qua một điểm tích hợp duy nhất.

Liên quan

Scribble Maps Developers

Scribble Maps Connect Picker

Nhập/Xuất tệp và dữ liệu – GeoJSON, ảnh, PDF, CSV, KML, GXP, SHP, DXF, SMJSON, SMT, WKT, v.v.

Nhập/Xuất: Mô tả, ví dụ, hạn chế và cách xử lý – CSV, DXF, GeoJSON, GPX, KML, KMZ, SHP