批量上传POI

Places Service中的 “导入POI”按钮可用于使用CSV文件批量上传新POI。 提供了示例电子表格模板,用于显示需要哪些数据列以及如何添加可选的自定义元数据。

批量导入屏幕

请观看此视频,其中显示批量导入和批量编辑的过程:

放置服务批量导入和编辑POI

Python API脚本

已创建一组Python脚本,以通过使用Web服务API简化从。csv文件到POI数据库的POI的批量导入。 这些脚本可从此开放源码git回 购库下载

在运行这些脚本之前,要访问Web服务API,请参阅集成 概述和先决条件中​的用户访问先决条件

以下是有关脚本的一些信息:

小贴士

此信息还包含在git repo的自述文 件中

CSV文件

示例。csv文件 places_sample.csv是此包的一部分,包括所需的标题和一行示例数据。 这些标题均为小写,与在Places数据库中使用的保留元数据键相对应。 您添加到。csv文件的列将作为键/值对添加到每个POI的单独元数据部分的POI数据库,并且头值用作键。

以下是您需要使用的列和值的列表:

  • lib_id

    从POI数据库获取的有效库ID。

  • type

    Point当前是唯一有效值。

  • longitude

    介于-180和180之间的值。

  • latitude

    介于-85和85之间的值。

  • radius

    介于10到20,000之间的值。

列值

以下列的值在Places Service UI中使用:

  • color,它用作pin的颜色,该颜色表示POI在Places Service UI映射中的位置。

    • 有效值为“”、#3E76D0、#AA99E8、#DC2ABA、#FC685B、#FC962E、#F6C436、#BECE5D、#61B56b、#3DC8DE和“”。

    • 如果该值留空,则Places Service UI使用蓝色作为默认颜色。

      这些值对应于蓝色(#3E76D0)、紫色(#AA99E8)、富斯基亚(#DC2ABA)、橙色(#FC685B)、浅橙色(#FC962E)、黄色(#F6C436)、浅绿色#BECE5D)、绿色(#61B56B)和浅蓝色(#3DC8DE)。

  • 图标,它用作pin上的图标,该图标表示POI在Places Service UI映射中的位置。

    • 有效值为“”、商店、酒店、汽车、火车、船、体育场、娱乐园、锚、贝克、钟、钟、标书、箱、公文包、浏览、刷子、建筑、计算器、钟、教育、手电筒、跟踪、游戏、女性、礼品、锤、心、家、钥匙、启动、灯泡、邮箱、销、促销、丝带、购物车、目标,茶壶,拇指向下,拇指向上,陷阱,奖杯,扳手。

      图标值按它们在下图中的显示顺序列出:

      图标

    • 如果该值留空,则UI将使用星形作为默认图标。

  • 未提及的列可留空。

运行脚本

  1. 将文件从git repo下载 到本地目录。

  2. 在文本编辑器中,打开文 config.py 件并完成以下任务:

    a.将以下变量值编辑为字符串:

    • csv_file_path

      这是文件的路 .csv 径。

    • access_code

      这是您从呼叫AdobeIMS中获取的访问代码。 有关如何获取此访问代码的信息,请参阅集成 概述和先决条件中​的用户访问先决条件

    • org_id

      要导入POI的Experience Cloud组织ID。 有关如何获取组织ID的信息,请参阅集成概 述和入门项目中户访问的先决条件

    • api_key

      这是您从您的Adobe I/O地集成获取的Places REST API密钥。 有关如何获取API密钥的信息,请参阅集成概 述和先决条件中​的用户访问先决条件
      b.保存更改。

  3. 在终端窗口中,导航到目 …/places-scripts/import/ 录。

  4. python ./places_import.py 入并按 enter ()return​键。

预导入CSV检查

脚本最初对。csv文件完成以下检查:

  • 是否指 .csv 定了文件。

  • 文件路径是否有效。

  • 是否包含保留的元数据标题。

    保留的元数据标题包括lib_id、name、description、type、longitude、latitude、radius、country、state、city、street、类别、图标和颜色。

    小贴士

    标题均采用小写形式,可按任意顺序列出。

  • 验证在CSV文件部分中指定的列的值。

如果发现错误,脚本将打印出错误并中止。 如果未找到错误,脚本将尝试以1000批次导入POI。 如果成功导入批,脚本将报告状态代码200。 如果未成功导入批,则报告错误。

设备测试

设备测试在文件 tests.py 中,应在每个拉取请求之前运行,并且所有测试都应通过。 应使用新代码添加其他测试。 要运行测试,请导航到目 …/places-scripts/import/ 录,然后在 python ./places_import.py 终端中输入。

On this page

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now