{"id":13607444,"url":"https://github.com/laboonly/widgets-map","last_synced_at":"2025-04-12T11:32:38.143Z","repository":{"id":124509775,"uuid":"431770103","full_name":"laboonly/widgets-map","owner":"laboonly","description":null,"archived":false,"fork":false,"pushed_at":"2022-06-02T11:33:21.000Z","size":336,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T05:05:22.925Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laboonly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-11-25T08:34:08.000Z","updated_at":"2025-01-16T08:37:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"51d1f85a-06d3-4ed8-a557-fadf957f5626","html_url":"https://github.com/laboonly/widgets-map","commit_stats":null,"previous_names":["laboonly/widgets-rent-map"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laboonly%2Fwidgets-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laboonly%2Fwidgets-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laboonly%2Fwidgets-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laboonly%2Fwidgets-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laboonly","download_url":"https://codeload.github.com/laboonly/widgets-map/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248560264,"owners_count":21124621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T19:01:18.691Z","updated_at":"2025-04-12T11:32:33.128Z","avatar_url":"https://github.com/laboonly.png","language":"TypeScript","readme":"# 地图小组件\n\n# 【小程序分享】地图信息展示\n分享一个可以在地图上展示表格信息的维格地图小程序。\n\n\u003e 已实现 添加标点以及对应的信息弹窗。\n\n## 项目地址\nhttps://github.com/laboonly/widgets-map\n\n## 功能介绍\n本小程序根据表格里面的地址在地图上显示对应的地点与详细信息。\n\n## 使用说明\n请先获取高德api的key[高德地图apikey获取](https://lbs.amap.com/api/javascript-api/guide/abc/prepare)，填入src/map.tsx的securityCode和apiKey，启动小程序之后选择，名称，地址，价格，联系方式对应表格的列，以及填入地图中心(公司)。\n\n## 最近更新\n 1. 将标记点功能与其他功能分开\n 2. 支持信息弹窗信息自定义\n\n下面分享一下开发过程\n\n## 开发过程\n正好在寻找房子的我，想到如果能用维格表小程序管理租房信息能够实现我找到最优房子的需求的地图小组件就好了,顺便介绍一下维格小程序以及高德地图相关方面的开发。\n\n### 计划需求\n需求整理，我期望的是小程序能够在地图上根据表格中的地址展示不同的标点，同时点击标点之后展示标点的详细信息，以及各个出租房到公司的距离。\t\n\n### 准备工作\n首先根据官方文档[快速上手开发 | 维格表开发者中心](https://vika.cn/developers/widget/quick-start)，创建安装好小程序。\n第二个是高德地图开发需要在高德开发者中心，注册号账号并且申请key,[准备-入门-教程-地图 JS API | 高德地图API](https://lbs.amap.com/api/javascript-api/guide/abc/prepare)。\n\t\n### 第一步加载地图\n高德JSAPI，更新了V2.0版本，一番尝试之后发现总是没办法加载成功，在咨询了维格的研发同学之后，才知道可能是因为维格对iframe支持有问题，于是决定不适用新版本的api使用之前V.14版本的api。\n\n但是v.14版本的api加载不支持npm，于是我借鉴了之前使用此版本api的react-amap开源框架，关于地图加载的部分。[源码链接](https://github.com/ElemeFE/react-amap/blob/next/components/utils/APILoader.js)，大概思路就是用JS创建script标签加载。首先在小程序的框架下创建utils/ApiLoader.js文件。复制上面链接中的代码。这里的地图mapStyle我使用了[高德的自定义主题](https://lbs.amap.com/api/javascript-api/guide/map/map-style)，你可以选择你喜欢的地图主题，或者自己配置.\n\n```tsx\n// 部分代码\n\n  const DEFAULT_CONFIG = {\n    v: ‘1.4.0’, // 版本号\n    hostAndPath: ‘webapi.amap.com/maps’, // 高德api加载地址\n    key: ‘’, // 高德apikey\n    callback: ‘_amap_init_callback’, // 回调函数\n    useAmapUI: true // 是否使用高德UI\n  }\n\n// 获取脚本链接\n  getScriptSrc(cfg) {\n      return `${this.protocol}//${cfg.hostAndPath}\n  ?v=${cfg.v}\u0026key=${cfg.key}\u0026callback=${cfg.callback}`;\n  }\n\n// 创建脚本js\n  buildScriptTag(src) {\n    const script = document.createElement(‘script’);\n    script.type = ‘text/javascript’;\n    script.async = true; // 异步执行\n    script.defer = true; // 页面加载完之后执行\n    script.src = src;\n    return script;\n  }\n```\n接下来我们在小程序工程src中创建map.tsx文件，引入APILoader，并且创建MapComponent函数组件。填入地图配置参数，这里要注意地图挂载的DOM要设置宽高.\n\n```tsx\nimport React, { useEffect, useState } from ‘react’;\nimport { Setting } from ‘./setting’;\nimport APILoader from ‘./utils/APILoader’;\n\n\n// 地图安全密钥\nconst securityCode = ‘高德开发者中心申请key附带的安全密钥’;\n// 高德地图api key\nconst apiKey = ‘高德开发者中心申请的key’;\n\n//设置地图安全密钥\nwindow[‘_AMapSecurityConfig’] = {\n  securityJsCode: securityCode,\n}\n\nexport const MapComponent: React.FC = () =\u003e {\n\t// 组件初始化时，加载 sdk 地图实例\n  useEffect(() =\u003e {\n   \n    new APILoader({\n        key: apiKey,\n        version: null,\n        protocol: ‘https’\n    }).load().then(() =\u003e {\n      const lnglat = new window.AMap.LngLat(114.031040, 22.624386);\n      const amap = new window.AMap.Map(‘container’, {\n        zoom: 12,//级别\n        center: lnglat,//中心点坐标\n        viewMode: ‘3D’,//使用3D视图\n        mapStyle: ‘amap://styles/b379277160c9c3ce520627ad2e4bd22c’\n      });\n      window.amap = amap;\n    }, []);\n    \n    return (\n    \u003cdiv style={{ display: ‘flex’, height: ‘100%’ }}\u003e\n      \u003cdiv style={{ flexGrow: 1, overflow: ‘auto’, padding: ‘0 8px’}}\u003e\n        \u003cdiv id=“container” style={{ width: ‘100%’, height: ‘100%’ }}\u003e\n      \u003c/div\u003e\n        \u003cSetting /\u003e\n    \u003c/div\u003e\n  );\n};\n```\n\n修改小程序index.tsx的默认代码.\n\n```tsx\nimport { initializeWidget } from '@vikadata/widget-sdk';\nimport { MapComponent } from './map';\n\ninitializeWidget(MapComponent, process.env.WIDGET_PACKAGE_ID!);\n\n```\n\n接下来我们打开维格小程序开发的网页就可以看到地图已经加载好了。\n\n地图加载好了之后，接下来我们需要根据表格中的地址创建好地图标点。\n首先在维格表中创建好名称，地址，优缺点，价格，联系方式等列，填入自己的数据。\n\n这里我们需要使用到两个插件，地图编码插件[geocoder](https://lbs.amap.com/api/javascript-api/guide/services/geocoder),[高德官方UI库](https://lbs.amap.com/api/amap-ui/intro)，在utils下面新建commons.js。实现加载插件代码。同样思路的还有后续的路线规划插件加载。\n\n```tsx\n\n// 加载高德地图地图插件\nfunction loadAmapUI() {\n  return new Promise\u003cobject\u003e(resolve =\u003e {\n    window.AMapUI.loadUI(['overlay/SimpleMarker'], (SimpleMarker: any) =\u003e {\n      resolve(SimpleMarker);\n    })\n  })\n}\n\n/ 加载高德地图地图编码插件\nfunction loadGeocoder() {\n  return new Promise\u003cobject\u003e(resolve =\u003e {\n    window.AMap.plugin('AMap.Geocoder', () =\u003e {\n      const geocoder = new window.AMap.Geocoder({\n        // city 指定进行编码查询的城市，支持传入城市名、adcode 和 citycode\n        city: '全国'\n      });\n      resolve(geocoder);\n    });\n  });\n}\n\n```\n\n由于这些插件以及高德地图api的加载是异步的所以我们将这些功能与地图上的功能分开,将之前的地图挂载元素分成mapcontent的小组件，在src中创建components/mapcontent,并且根据维格小程序官方api修改src/seting.tsx. 然后使用useCloudStorage来获取用户设置名称地址等，对应的列的id。然后使用record.getCellValue来获取对应的值。接下来根据这个值通过上面提得到geocoder插件根据地址查询对应点的坐标值，最后使用[高德AMapUI](https://lbs.amap.com/api/amap-ui/reference-amap-ui/overlay/simplemarker)创建对应地址的标点。\n\nmapcontent/index.tsx\n\n```tsx\n// 以下是部分代码完整源码请在github查看\n\nimport React, { useState, useEffect } from 'react';\nimport { useCloudStorage, useRecords } from '@vikadata/widget-sdk';\nimport { getLocationAsync, creatTransfer } from '../../utils/common';\nexport const MapContent: React.FC\u003cmapContentProps\u003e = ({ pluginStatus  }) =\u003e {\n  // 获取表格视图ID\n  const [viewId] = useCloudStorage\u003cstring\u003e('selectedViewId');\n  // 获取所有行的信息\n  const records = useRecords(viewId);\n  // 处理完的表格信息\n  const [recordsData, setRecordsdata] = useState\u003cany\u003e();\n  // 名称\n  const [titleId] = useCloudStorage\u003cstring\u003e('selectedtitleId');\n  // 地址\n  const [addressId] = useCloudStorage\u003cstring\u003e('selectedAddressId');\n  // 优缺点\n  const [houseInfoId] = useCloudStorage\u003cstring\u003e('selectedHouseInfoId');\n  // 价格\n  const [priceId] = useCloudStorage\u003cstring\u003e('selectPrice');\n  // 联系方式\n  const [contactId] = useCloudStorage\u003cstring\u003e('selectContact');\n  // 地图中心地址\n  const [mapCenter] = useCloudStorage\u003cstring\u003e('mapCenter');\n\n  // 地址处理\n  useEffect(function getAddressList() {\n    // 获取表格所有地址\n    const recordsData: any[] = records\n      .map(record =\u003e { \n        return { \n          title: record.getCellValue(titleId),\n          address: record.getCellValue(addressId),\n          info: record.getCellValue(houseInfoId),\n          price: record.getCellValue(priceId),\n          contact: record.getCellValue(contactId)\n        }\n      });\n    setRecordsdata(recordsData);\n  },[records, titleId, addressId, houseInfoId, priceId, contactId]);\n\n  // 根据表格设置所有地图点\n  useEffect(function drawAddress() {\n    console.log('pluginStatus', pluginStatus);\n    if (!pluginStatus || !recordsData  || !mapCenterLocation) {\n      return;\n    }\n    markAddress(recordsData, markersLayer, mapCenterLocation, informationRef);\n  }, [recordsData, mapCenterLocation, pluginStatus]);\n\n  /* 创建标记点 \n  record: 标点信息\n  markerConfig: 标点参数配置\n  transfer: 创建路径对象\n  informationRef: 信息窗体DOM引用\n  */\n  function creatMarker(\n    record: any, \n    markerConfig: markConfig,\n    mapCenterLocation?: locationType,\n    informationRef?: any,\n  ) {\n\n    const marker =  new window.SimpleMarker({\n      ...markerConfig,\n      //...其他Marker选项...，不包括content\n      map: window.amap,\n      clickable: true,\n      position: [record.location.lng, record.location.lat]\n    });\n    \n    if(mapCenterLocation) {\n      marker.on('click', () =\u003e {\n        setHouseinfo(record);\n        const infoWindow = new window.AMap.InfoWindow({\n            content: informationRef.current.innerHTML,  //传入 dom 对象，或者 html 字符串\n            offset: new window.AMap.Pixel(0, -40),\n            closeWhenClickMap: true, // 点击地图关闭\n            autoMove: true\n        });\n        creatTransfer([mapCenterLocation.lng, mapCenterLocation.lat], [record.location.lng, record.location.lat]);\n        infoWindow.open(window.amap, [record.location.lng, record.location.lat]);\n      });\n    }\n    return marker;\n  }\n\n  /* 根据地址搜索增加marker点 \n  recordsData: 表格数据\n  markersLayer: 之前已经创建的marker图层\n  setHouseinfo: 设置标点信息函数\n  mapCenterLocation: 中心点坐标\n  informationRef: 信息窗口DOM\n  */\n  async function markAddress( \n    recordsData: Array\u003cany\u003e, \n    markersLayer: Array\u003cany\u003e, \n    mapCenterLocation: locationType,\n    informationRef: any,\n  ) {\n\n    if(markersLayer) {\n      window.amap.remove(markersLayer);\n    }\n\n    const asyncRecords = recordsData.map(record =\u003e getLocationAsync(record));\n    const Records = await Promise.all(asyncRecords);\n    const markers = Records.map((record: any) =\u003e { \n      return creatMarker(record, homeMarkerConfig, mapCenterLocation, informationRef);\n    });\n\n    setMakerslayer(markers);\n  }\n\n  return (\n    \u003cdiv style={{ width: '100%', height: '100%' }}\u003e\n      \u003cdiv id=\"container\" style={{ width: '100%', height: '100%' }}\u003e\n      \u003c/div\u003e\n    \u003c/div\u003e\n  );\n\n});\n\n```\n\n另外我们需要在setting.tsx里面设置名称，地址等信心对应的列。通过useCloudStorage保存。使用小程序官方的FieldPicker组件选择对应的字段获取ID。\n\n```tsx\n// 以下是部分代码完整源码请在github查看\n\nexport const Setting: React.FC = () =\u003e {\n\n  const [isSettingOpened] = useSettingsButton();\n\n  // 名称\n  const [titleId, settitleId] = useCloudStorage\u003cstring\u003e('selectedtitleId');\n  // 地址\n  const [addressId, setAddressId] = useCloudStorage\u003cstring\u003e('selectedAddressId');\n  // 优缺点\n  const [houseInfoId, setHouseInfoId] = useCloudStorage\u003cstring\u003e('selectedHouseInfoId');\n  // 价格\n  const [priceId, setPriceId] = useCloudStorage\u003cstring\u003e('selectPrice');\n  // 联系方式\n  const [contactId, setContactId] = useCloudStorage\u003cstring\u003e('selectContact');\n\n  return isSettingOpened ? (\n    \u003cdiv style={{ flexShrink: 0, width: '300px', borderLeft: 'solid 1px gainsboro'}}\u003e\n      \u003ch1 style={{ paddingLeft: \"5px\", marginBottom: 0 }}\u003e设置\u003c/h1\u003e\n      \u003cdiv style={{ display: 'flex', height: '100%' }}\u003e\n        \u003cdiv style={{ flexGrow: 1, overflow: 'auto'}}\u003e\n        \u003cBox\n          padding=\"30px 10px 60px 10px\"\n          borderBottom=\"2px solid lightgrey\"\n        \u003e\n          \u003cFormItem label=\"View\" \u003e\n            \u003cViewPicker   viewId={viewId} onChange={option =\u003e setViewId(option.value)} /\u003e\n          \u003c/FormItem\u003e\n          \u003cFormItem label=\"名称\"\u003e\n            \u003cFieldPicker viewId={viewId} fieldId={titleId} onChange={option =\u003e settitleId(option.value)} /\u003e\n          \u003c/FormItem\u003e\n          \u003cFormItem label=\"地址\"\u003e\n            \u003cFieldPicker viewId={viewId} fieldId={addressId} onChange={option =\u003e setAddressId(option.value)} /\u003e\n          \u003c/FormItem\u003e\n          \u003cFormItem label=\"优缺点\"\u003e\n            \u003cFieldPicker viewId={viewId} fieldId={houseInfoId} onChange={option =\u003e setHouseInfoId(option.value)} /\u003e\n          \u003c/FormItem\u003e\n          \u003cFormItem label=\"价格\"\u003e\n            \u003cFieldPicker viewId={viewId} fieldId={priceId} onChange={option =\u003e setPriceId(option.value)} /\u003e\n          \u003c/FormItem\u003e\n          \u003cFormItem label=\"联系方式\"\u003e\n            \u003cFieldPicker viewId={viewId} fieldId={contactId} onChange={option =\u003e setContactId(option.value)} /\u003e\n          \u003c/FormItem\u003e\n          \u003cFormItem label=\"地图中心\"\u003e\n            \u003cTextInput  style={{  width: '100%!important' }} size=\"small\" value={inputCenter} onChange={ e =\u003e setInputcenter(e.target.value)} /\u003e\n            \u003cButton  style={{ marginTop: 8}} color=\"primary\" size=\"small\" onClick={confirmCenter}\u003e\n              确定\n            \u003c/Button\u003e\n          \u003c/FormItem\u003e\n        \u003c/Box\u003e\n        \u003c/div\u003e\n      \u003c/div\u003e\n    \u003c/div\u003e\n  ) : null;\n\n});\n```\n\n到这里我们基本上完成了从表格中获取值然后在地图上实现标点等功能，后续的详细信息展示以及路线规划也可以使用\n相应的插件完成。我已经将源码上传至https://github.com/laboonly/widgets-rent-map 欢迎Star⭐️.\n\n## 后续计划\n\n1. —将标点,信息展示，路线规划变为组件由用户自己选择展示。—\n2. 添加更多地图功能，如范围点等。\n","funding_links":[],"categories":["🎯开源维格小程序"],"sub_categories":["第三方开源"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaboonly%2Fwidgets-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaboonly%2Fwidgets-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaboonly%2Fwidgets-map/lists"}