地点资料库
地点资料库以集合的形式保存组织的地点：你的门店、你的房源、你的场所。你只需从文件、Google 表格或数据源导入一次集合，检查每个地点的落点，然后发布。之后组织的每张地图都可以把它显示为图钉、门店查找或房源列表页面，这些地图上的 Kaleidr AI 也会根据它回答问题。
集合不同于地图上的数据集。数据集只属于你添加它的那一张地图；集合属于组织，你只需在一处更新，所有显示它的地图都会随之更新。
| 地图上的数据集 | 地点资料库集合 | |
|---|---|---|
| 归属 | 你添加它的地图 | 组织 |
| 内容 | 任何表格、地理文件或图像叠加层 | 地点：每行一个点，带名称 |
| 更新方式 | 在每张地图上替换数据集 | 一次导入，作用于所有显示该集合的地图 |
| 私密列 | 不支持：访客会收到所有列 | 支持：标记为私密的列永远不会离开 Studio |
| 门店查找和房源列表布局 | 不支持 | 支持 |
| 套餐 | Free、Pro 和 Enterprise | Free、Pro 和 Enterprise |
找到资 料库
登录 Kaleidr Studio，在左侧导航栏中选择数据。资料库列出组织的集合，并显示每个集合的记录数、上次发布时间、是否按计划刷新以及有多少张地图显示它。顶部横条显示你的套餐允许多少集合和地点，以及你已使用多少。
所有者、管理员和成员可以创建、导入和修改集合。查看者可以打开集合并查看其中的地点。
集合
选择新建集合，选择一种类型并为其命名。类型决定导入助手首先提供哪些字段，以及地点卡片的外观：
| 类型 | 用于 | 首先提供的字段 |
|---|---|---|
| 门店 | 零售门店。Retail 套件。 | 名称、地址、类别、营业时间、时区、电话、网站、操作链接、你的 ID、状态 |
| 房源 | 出售或出租的房产。Property 套件。 | 名称、地址、价格、货币、卧室、浴室、照片、状态、操作链接、电话、你的 ID、描述 |
| 场所 | 酒店、餐厅和景点。Hospitality 套件。 | 名称、地址、类别、营业时间、电话、网站、照片、描述、操作链接、你的 ID |
| 站点 | 计划停靠点，例如餐车的路线或接送点。Location 套件。 | 名称、地址、营业时 间（服务时段）、时区、状态、车辆、服务日期、描述、你的 ID |
| 车辆 | 车队的车辆，在地图上实时显示。参阅实时追踪。 | 无：车辆在 Studio 中添加到车队，而不是导入 |
| 自定义 | 其他任何地点 | 名称、地址、类别、描述、你的 ID |
每种类型都可以包含你自己的列。门店、房源、场所或站点集合一开始就带有其套件的卡片、筛选和操作，你可以修改它们。车辆集合不接受导入：其车辆在 Studio 的车队部分管理。
站点集合的营业时间就是它的服务时段。状态为 paused 的站点在任何一天都不运营；车辆列指明服务该站点的车辆；服务日期列列出它运营的仅有日期。参阅站点时刻表。
导入数据
在集合中选择导入数据。导入助手分为五个步骤。
1. 添加数据
用以下三种方式之一导入数据：
| 来源 | 需要提供 | 可刷新 |
|---|---|---|
| 文件 | CSV、TSV、Excel、ODS、GeoJSON、KML、GPX 或压缩为 zip 的 shapefile | 否：如需更新，请导入新文件 |
| Google 表格 | 以 https://docs.google.com/spreadsheets/d/ 开头的表格链接。请先将表格共享为“知道链接的任何人都可以查看”；需要登录的表格无法读取。指向某个标签页的链接会读取该标签页。 | 是 |
| 数据源 | CSV、JSON 或 GeoJSON 文件的 https:// 地址 | 是 |
- 地点是一个点。 地图文件必须包含点；线和面会被拒绝。GeoTIFF 等图像叠加层不是地点，也会被拒绝。
- 每一行都需要名称，以及地址或坐标。 有坐标的行会准确放在坐标所指的位置。只有地址的行根据地址放置。
- 下载示例表格可获得该集合套件的已填写示例，其中包含套件卡片读取的列。
2. 匹配列
Studio 为数据的每一列显示一行，包括示例值以及该列匹配到的字段。一个标签说明匹配方式：
| 标签 | 含义 |
|---|---|
| 已匹配 | 列名是该字段的已知名称，例如“Latitude”或“Store Name”。 |
| 近似匹配 | 列名与某个已知名称相近。 |
| AI 建议 | 对于仅凭名称无法确定的列，由 Kaleidr AI 建议了字段。它读取你的列名和前五行来建议匹配，从不写入或更改你的数据。该建议计入组织的 Kaleidr AI 用量。 |
检查每一行，修改任何错误的字段。一列可以是：
- 该类型的标准字段，例如名称、地址、营业时间或价格。标准字 段始终公开。
- 自定义列，使用你自己的标签，并设为公开或私密。
- 忽略，不导入该列。
街道、城市、地区、邮政编码和国家列会合并为一个地址。纬度和经度可以是两列，也可以是同时包含两者的一列，顺序不限。请选择集合营业时间所使用的时区。
私密列只留在你这里。 私密列为你保存在 Studio 中，永远不会发送到访客的浏览器，也不会被 Kaleidr AI 读取。若要让电话号码等标准字段保持私密，请改为将其匹配为私密自定义列。
3. 放置图钉
Studio 把每一行放到地图上。有坐标的行保留其坐标。有地址的行只根据地址放置，从不根据地点名称，因此同一品牌的两家分店不会落在一起。
随后 Studio 会显示已放置、待检查和未找到的行数，并在地图旁显示检查列表：
- 接受图钉保留 Studio 以低置信度放置的图钉。
- 修正图钉让你拖动图钉或点击地图，把它放到地点所在位置。
- 移除将该行排除在本次导入之外。
没有图钉的行无法发布。请修正或移除该行，或选择跳过无图钉的行，在不含这些行的情况下发布。
4. 清理
Studio 按类别分组建议更改，在你 接受之前不会做任何更改：
| 类别 | 发现的内容 |
|---|---|
| 重复项 | ID 相同的行，或同一位置名称相同的行。接受后保留第一行。 |
| 营业时间 | 用其他方式书写的营业时间，例如 Mon-Fri 9am-5pm; Sat 10-4，会改写为统一格式。Studio 无法读取的营业时间会在该行中标出并留空。 |
| 类别 | 同一类别仅在大小写、空格或单复数上不同的写法，合并到集合的现有类别中。 |
| 网站 | 缺少 https:// 的网址，会被补全。 |
对每项选择接受或保留原值，或选择全部接受。发布前，每项更改都需要做出决定。
5. 发布
发布会用本次导入替换集合中的地点。所有显示该集合的地图会在下次加载时显示新地点。地点在多次导入之间保持身份不变，因此指向某家门店的链接或卡片在你刷新数据后仍指向它。
发布后，你可以选择添加到地图；对于 Google 表格或数据源，还可以选择设置刷新计划。
保持最新
从 Google 表格或数据源导入的集合，其刷新部分会重新读取该链接：
- 立即刷新适用于所有套餐，使用上次的列匹配读取链接。如果表格的列发生了变化，导入会停在 “匹配列”步骤，等你检查。
- 计划刷新适用于 Pro 和 Enterprise，按你选择的间隔刷新，但不会超过套餐允许的频率（参阅限制）。开启自动发布后，刷新会自行发布；但如果需要检查，或地点数量变化超过一半，则会等待你处理。
- 反复失败会暂停计划。 该部分会显示上次运行及其结果。
列、卡片、筛选和操作
打开集合即可更改其显示方式。每个部分都是一个可折叠区域：
- 记录：所有地点，支持搜索。私密列会有标记。
- 列：每列的标签、公开或私密、卡片位置及其顺序。可见性的更改会应用到所有显示该集合的地图。
- 卡片和筛选：实时卡片预览、门店查找或房源列表页面提供的访客筛选，以及每张卡片上的地点操作。
卡片在访客选择地点时显示该地点。卡片位置决定各内容的位置：标题、副标题、图片、价格、最多三个徽标、最多四个详情行，以及一行署名。地点没有的字段不会出现在卡片上，绝不会显示为空。门店卡片显示根据地点所在时区的营业时间计算出的正在营业或已打烊。房源卡片在价格正下方显示署名行， 例如经纪公司和经纪人的“房源提供”。
访客筛选，按你设置的顺序显示：
| 筛选 | 访客可以 |
|---|---|
| 搜索 | 输入名称、地址或类别。 |
| 类别 | 选择一个或多个类别。 |
| 价格 | 设置最低值和最高值。 |
| 卧室 / 浴室 | 选择 1+、2+、3+ 或 4+。 |
| 正在营业 | 只显示此刻正在营业的地点。开启时，没有营业时间的地点会被隐藏。 |
地点操作，每张卡片最多四个：
| 操作 | 访客得到的内容 |
|---|---|
| 链接 | 一个在新标签页中打开你的某个页面的按钮，例如“Shop”或“Schedule a Tour”。地址只需写一次，在每个地点 ID 的位置写 {id}；地点自己的操作链接会替代它。地址必须以 https:// 开头。 |
| 路线 | 在地图上绘制从访客所在位置或其搜索的地点出发的路线，并提供在 Apple 地图或 Google 地图中打开前往该地点路线的按钮。 |
| 致电 | 拨打地点电话号码的电话链接。 |
| 请求 | 一个按钮，例如 Reserve、Schedule a Tour 或 Request Pickup，用于打开请求表单。请求会送达你组织的收件箱。参阅预订请求。 |
将集合添加到地图
有两种方式，结果相同：
- 在地图的数据面板中选择从资料库添加，然后选择一个集合。
- 在集合中选择添加到地图，然后选择一张地图。
集合会成为地图的一个图层，你可以像设置其他图层一样设置其样式。房源绘制为价格标签；其他类型绘制为圆点。一张地图可以显示多个集合，一个集合也可以出现在组织的任意多张地图上。
地图发布后，访客只能看到集合的公开列。更新集合会更新所有显示它的地图，无需重新发布。
Kaleidr AI 根据它回答。 在开启了 Control Tower 的已发布地图上，Ask Kaleidr 面板会根据集合中的地点及其公开列回答“最近的有停车位的门店”之类的问题，并说明其回答由 AI 生成。参阅已发布地图上的 Chat。
将其嵌入为门店查找或房源列表页面。 locator 和 listings 布局会在地图旁显示可搜索的集合列表，附带其筛选和卡片。参阅地点布局。
套件
有四种集合类型附带套件：协同工作的卡片、筛选、操作和 viewer 布局，以及一份可作为起点的示例表格。
| 套件 | 集合类型 | 布局 | 筛选 | 操作 |
|---|---|---|---|---|
| Retail | 门店 | locator | 搜索、类别、正在营业 | 路线、致电、Shop |
| Property | 房源 | listings | 价格、卧室、浴室 | Schedule a Tour、Contact Agent |
| Hospitality | 场所 | guide | 搜索、类别、正在营业 | Book、路线、Reserve |
| Location | 站点 | live | 搜索、正在营业 | 路线、Request Pickup |
模板生成器中的套件模板会创建一张已包含这种结构示例集合的地图，并按套件的布局生成嵌入代码。向该集合导入数据，即可用你自己的地点替换示例地点。示例集合计入你的集合限制；达到限制时，地图会在不含示例集合的情况下创建。Location 模板包含示例站点，但没有车队：请在 Studio 的车队部分添加你的车辆。你的组织接受请求后，Reserve 和 Request Pickup 操作才会出现。
删除集合
删除集合位于集合页面底部。如果你的地图中有显示该集合的，Studio 会先列出这些地图，选择仍然删除会照样删除。删除集合会永久删除其地点和导入的文件。曾显示它的地图会继续工作，只是不再包含该集合。
删除组织时，其集合也会一并删除。
限制
| 限制 | Free | Pro | Enterprise |
|---|---|---|---|
| 集合 | 3 | 25 | 在合同中约定 |
| 单个集合中的地点 | 1,000 | 25,000 | 100,000 |
| 所有集合中的地点 | 3,000 | 250,000 | 在合同中约定 |
| 计划刷新 | 无：仅限立即刷新 | 最多每天一次 | 最多每小时一次 |
| 单个文件、表格或数据源的大小 | 32 MiB | 64 MiB | 64 MiB |
在所有套餐中，一个集合最多包含 100,000 个地点和 100 列，一个单元格最多 2,000 个字符。限制只会阻止新的操作：超出限制的组织仍保留已发布的内容。
在已发布地图上，地址搜索和路线规划分别限制为每位访客每分钟 20 次、每张地图每天 2,000 次。它们不计入你的 Kaleidr AI 用量。