跳至主要内容

連線

連線使用你組織在供應商的自有帳戶,在已發佈地圖的地點卡片上顯示該供應商的內容:例如場所在 Yelp 上的評分和評論數,或某個場館在 Ticketmaster 上的近期活動。API 金鑰由你提供;內容依該金鑰適用的供應商條款顯示。

供應商顯示內容狀態
Yelp商家的評分、評論數、價格等級和類別,並附其 Yelp 頁面連結已提供
Ticketmaster該場館未來 14 天內最多五場活動,每場附 Ticketmaster 連結已提供
Tripadvisor無需要與 Tripadvisor 簽署的內容協議
Google Places無不提供

連線供應商​

  1. 使用你組織的自有帳戶,依供應商的條款取得 API 金鑰。
  2. 在 Kaleidr Studio 中選擇資料,然後開啟連線分頁。
  3. 在供應商的卡片上選擇連線,然後貼上金鑰。

Studio 在儲存金鑰前會呼叫一次供應商來檢查金鑰。供應商拒絕的金鑰不會被儲存。金鑰儲存後不會再顯示:卡片只顯示其最後四個字元、上次檢查的時間和狀態。更換金鑰用於更換金鑰,立即檢查會再次測試,中斷連線會刪除金鑰並停止所有地圖上的卡片。

擁有者和管理員可以連線、更換和中斷連線。組織中的每個人都能看到狀態。

狀態含義
未連線沒有金鑰。
已連線金鑰有效。
金鑰遭拒供應商在最近一次使用時拒絕了該金鑰。在你更換之前,卡片會停止顯示。
需要合約Tripadvisor:沒有簽署的協議則無法使用。

內容顯示在哪裡​

只在地點卡片上。 在已發佈地圖上,場所集合的卡片會在其自身各列下方顯示供應商的內容,與導覽版面中相同。Kaleidr AI 從不讀取、引用或在回答中使用這些內容,它們也從不儲存在你的集合中。

哪個商家或場館。 在場所集合中加入公開欄位 yelp_id 或 ticketmaster_venue_id,即可指定確切的商家或場館。沒有該欄位時,卡片會在 Yelp 上尋找地點位置處同名的商家,並在 Ticketmaster 上尋找 200 公尺內場館的活動。

僅供顯示,使用你的金鑰。 為你的地圖發出的呼叫只使用你組織的金鑰,你的金鑰也絕不會用於他人的地圖。

快取與出處標示​

供應商內容最長保留出處標示
Yelp6 小時Yelp 的名稱和標誌,以及該商家在 Yelp 上的連結
Ticketmaster1 小時Ticketmaster 的名稱和標誌,以及每場活動的連結

卡片在這些限制內重新整理,訪客的瀏覽器最多保留卡片五分鐘。用於將地點與商家或場館對應的供應商自有識別碼會無限期保留,這是兩家供應商的條款所允許的。

Ticketmaster 限制每個金鑰每天的呼叫次數;你的地圖上的卡片每天使用你的金鑰最多呼叫 4,500 次,達到後直到隔天都不再顯示活動。

為什麼不提供 Tripadvisor 或 Google Places​

  • Tripadvisor 的內容只能在與 Tripadvisor 簽署的內容協議下顯示。它在 Studio 中的卡片保持停用,並顯示需要與 Tripadvisor 簽署內容協議。
  • Google Places 的內容只能顯示在 Google 地圖上。Kaleidr 地圖繪製的是 Kaleidr 自己的底圖,因此不提供 Google Places。

相關內容​