Scribble Maps 帮助中心
更改语言

将 ScribbleMaps 添加到您的应用

注意:
当您希望用户登录到 Scribble Maps、浏览其可用地图并将地图数据直接返回到您的 Web 应用程序时，请使用 ScribbleMaps Connect Picker。
 
该选择器会在弹出窗口中打开并在其中处理用户登录过程，因此您的应用程序无需直接收集 Scribble Maps 凭据。

目录

 
 

Connect Picker 的工作原理

ScribbleMaps Connect Picker 允许您的用户浏览、搜索和选择来自 Scribble Maps 的地图，然后以您选择的格式将该地图数据直接返回到您的应用程序。

当您希望用户在 Scribble Maps 中创建或管理地理数据，然后将该数据加载到您自己的应用中，而无需构建您自己的地图浏览器或登录流程时，这非常有用。

使用场景 / 示例:

此集成适用于仪表板、属性工具、现场数据应用以及其他需要用户从 Scribble Maps 选择和加载地图数据的 Web 应用。

查看目录 ↑

 
 

获取您的 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);
  }
});
    当选择器打开时，用户可以进行身份验证、浏览其可用地图并选择其中一个。

查看目录 ↑

 
 

处理选定的地图数据

  1. 在 onSelect 回调中，访问 result.data。

    这包含您请求的格式的地图数据。
     

  2. （可选）使用其他返回的字段：

    • result.title — 地图标题
    • result.mapCode — Scribble Maps 地图代码
    • result.thumbUrl — 地图的缩略图 URL
     

  3. 将数据传递到您的应用程序逻辑中。

    For example, load the returned GeoJSON into your own map viewer or data workflow.

查看目录 ↑

 
 

可选配置

您可以配置选择器以更好地匹配您的应用程序工作流。

  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 开发者

Scribble Maps Connect Picker

导入/导出文件和数据 - GeoJSON、图像、PDF、CSV、KML、GXP、SHP、DXF、SMJSON、SMT、WKT 等。

导入/导出：说明、示例、限制和解决方法 - CSV、DXF、GeoJSON、GPX、KML、KMZ、SHP

 
 

最后更新