批量上传POI bulk-upload-pois
此 导入POI Places服务中的按钮可用于使用CSV文件批量上传新POI。 提供了一个电子表格模板示例,用于显示需要哪些数据列以及如何添加可选的自定义元数据。
请观看此视频,其中显示了批量导入和批量编辑的过程:
Python API脚本
已创建了一组Python脚本,以简化使用Web服务API将.csv文件中的POI批量导入POI数据库的过程。 可以从此开源下载这些脚本 git存储库.
在运行这些脚本之前,要访问Web服务API,请参阅 用户访问的先决条件 在 集成概述和先决条件.
以下是有关脚本的一些信息:
CSV文件
一个.csv示例文件, places_sample.csv
,是此包的一部分,并包含所需的标头和示例数据行。 这些标头全部为小写,对应于Places数据库中使用的保留元数据键。 您添加到.csv文件中的列将作为键/值对添加到POI数据库的单独元数据部分中,并且标头值将用作键/值对。
以下是您需要使用的列和值的列表:
-
lib_id
从POI数据库获取的有效库ID。
-
type
点是当前唯一的有效值。
-
longitude
介于–180和180之间的值。
-
latitude
介于–85和85之间的值。
-
radius
介于10和20,000之间的值。
列值
以下列的值在Places服务UI中使用:
-
颜色,用作pin的颜色,表示POI在Places服务UI映射中的位置。
-
有效值为“”、#3E76D0、#AA99E8、#DC2ABA、#FC685B、#FC962E、#F6C436、#BECE5D、#61B56B和#3DC8DE以及“”。
-
如果该值留空,则Places服务UI使用蓝色作为默认颜色。
这些值分别对应于蓝色(#3E76D0)、紫色(#AA99E8)、紫红色(#DC2ABA)、橙色(#FC685B)、浅橙色(#FC962E)、黄色(#F6C436)、浅绿色(#BECE5D)、绿色(#61B56B)和浅蓝色(#3DC8DE)。
-
-
图标,用作pin上的图标,表示POI在Places服务UI映射上的位置。
-
有效值为“”、商店、旅馆床、汽车、飞机、火车、船、体育场、游乐场、锚点、烧杯、铃、出价、书、盒、公文包、浏览、刷子、建筑物、计算器、相机、时钟、教育、手电筒、追踪、游戏、女性、男性、礼物、锤子、心、家、钥匙、发射、灯泡、邮箱、钱、大头针、促销活动、带状物、购物车、星星、目标、茶壶、thumbDown、thumbUp、陷阱、奖杯、扳手。
图标值按其显示顺序如下图所示:
-
如果将该值留空,则UI使用星形作为默认图标。
-
-
未提及的列可以留空。
运行脚本
-
从下载文件 git存储库 到您的本地目录。
-
在文本编辑器中,打开
config.py
并完成以下任务:a.将以下变量值编辑为字符串:
-
在终端窗口中,导航到
…/places-scripts/import/
目录。 -
输入
python ./places_import.py
然后按下 进入 (return)键。
预导入CSV检查
脚本最初完成对.csv文件的以下检查:
-
是否
.csv
指定文件。 -
文件路径是否有效。
-
是否包含保留的元数据标头。
保留的元数据标头为lib_id、名称、描述、类型、经度、纬度、半径、国家/地区、州/省、城市、街道、类别、图标和颜色。
note tip TIP 标头全部为小写,可以按任意顺序列出。 -
验证CSV文件部分中指定的列的值。
如果发现错误,脚本将打印出错误并中止。 如果未发现错误,脚本将尝试批量导入1000个POI。 如果已成功导入批次,脚本将报告状态代码200。 如果未成功导入批次,则会报告错误。
单元测试
单元测试位于 tests.py
文件,应在每个拉取请求之前运行,并且应全部通过。 应使用新代码添加其他测试。 要运行测试,请导航到 …/places-scripts/import/
目录,并输入 python ./places_import.py
在终端。