連線
連線使用你組織在供應商的自有帳戶,在已發佈地圖的地點卡片上顯示該供應商的內容:例如場所在 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。