连接
连接使用你组织在提供商处的自有账户，在已发布地图的地点卡片上显示该提供商的内容：例如场所在 Yelp 上的评分和评论数，或某个场馆在 Ticketmaster 上的近期活动。API 密钥由你提供；内容按该密钥适用的提供商条款显示。
| 提供商 | 显示内容 | 状态 |
|---|---|---|
| Yelp | 商家的评分、评论数、价格档次和类别，并附其 Yelp 页面链接 | 已提供 |
| Ticketmaster | 该场馆未来 14 天内最多五场活动，每场附 Ticketmaster 链接 | 已提供 |
| Tripadvisor | 无 | 需要与 Tripadvisor 签署的内容协议 |
| Google Places | 无 | 不提供 |
连接提供商
- 使用你组织的自有账户，按提供商的条款获取 API 密钥。
- 在 Kaleidr Studio 中选择数据，然后打开连接标签页。
- 在提供商的卡片上选择连接，然后粘贴密钥。
Studio 在保存密钥前会调用一次提供商来检查密钥。提供商拒绝的密钥不会被保存。密钥保存后不会再显示：卡片只显示其最后四个字符、上次检查的时间和状态。更换密钥用于更换密钥，立即检查会再次测试，断开连接会删除密钥并停止所有地图上的卡片。
所有者和管理员可以连接、替换和断开连接。组织中的每个人都能看到状态。
| 状态 | 含义 |
|---|---|
| 未连接 | 没有密钥。 |
| 已连接 | 密钥有效。 |
| 密钥被拒绝 | 提供商在最近一次使用时拒绝了该密钥。在你替换之前，卡片会停止显示。 |
| 需要合同 | Tripadvisor：没有签署的协议则无法使用。 |
内容显示在哪里
仅在地点卡片上。 在已发布地图上，场所集合的卡片会在其自身各行下方显示提供商的内容，与导览布局中一样。Kaleidr AI 从不读取、引用或在回答中使用这些内容，它们也从不存储在你的集合中。
哪个商家或场馆。 在场所集合中添加公开列 yelp_id 或 ticketmaster_venue_id，即可指定确切的商家或场馆。没有该列时，卡片会在 Yelp 上查找地点位置处同名的商家，并在 Ticketmaster 上查找 200 米内场馆的活动。
仅用于显示，使用你的密钥。 为你的地图发起的调用只使用你组织的密钥，你 的密钥也绝不会用于他人的地图。
缓存与署名
| 提供商 | 内容最长保留 | 署名 |
|---|---|---|
| Yelp | 6 小时 | Yelp 的名称和标志，以及该商家在 Yelp 上的链接 |
| Ticketmaster | 1 小时 | Ticketmaster 的名称和标志，以及每场活动的链接 |
卡片在这些限制内刷新，访客的浏览器最多保留卡片五分钟。用于将地点与商家或场馆对应的提供商自有标识符会无限期保留，这是两家提供商的条款所允许的。
Ticketmaster 限制每个密钥每天的调用次数；你的地图上的卡片每天使用你的密钥最多调用 4,500 次，达到后直到第二天都不再显示活动。
为什么不提供 Tripadvisor 或 Google Places
- Tripadvisor 的内容只能在与 Tripadvisor 签署的内容协议下显示。它在 Studio 中的卡片保持停用，并显示需要与 Tripadvisor 签署内容协议。
- Google Places 的内容只能显示在 Google 地图上。Kaleidr 地图绘制的是 Kaleidr 自己的底图，因此不提供 Google Places。