連携
連携は、組織がその提供元に持つ独自のアカウントで、提供元のコンテンツを公開済み地図のスポットのカードに表示します。施設の Yelp の評価とレビュー数や、会場の今後のイベントを Ticketmaster から表示できます。API キーはお客様が用意し、コンテンツはそのキーに適用される提供元の規約に従って表示されます。
| 提供元 | 表示内容 | 状態 |
|---|---|---|
| Yelp | 事業者の評価、レビュー数、価格帯、カテゴリ。Yelp のページへのリンク付き | 提供中 |
| Ticketmaster | 今後 14 日以内の会場のイベント最大 5 件。それぞれ Ticketmaster へのリンク付き | 提供中 |
| Tripadvisor | なし | Tripadvisor との署名済みコンテンツ契約が必要 |
| Google Places | なし | 提供なし |
提供元を接続する
- 組織独自のアカウントで、提供元の規約に従って API キーを取得します。
- Kaleidr Studio で データ を選び、連携 タブを開きます。
- 提供元のカードで 連携する を選び、キーを貼り付けます。
Studio は保存前に提供元への 1 回の呼び出しでキーを確認します。提供元に拒否されたキーは保存されません。保存したキーは二度と表示されません。カードには末尾 4 文字、最後に確認した日時、状態だけが表示されます。キーを置き換える でキーを入れ替え、今すぐ確認 で再テストし、連携を解除 でキーを削除してすべての地図のカードを止めます。
接続、置き換え、接続解除ができるのはオーナーと管理者です。状態は組織の全員が見られます。
| 状態 | 意味 |
|---|---|
| 未連携 | キーがありません。 |
| 連携済み | キーは有効です。 |
| キーが拒否されました | 最後に使ったときに提供元がキーを拒否しました。置き換えるまでカードは止まります。 |
| 契約が必要 | Tripadvisor：署名済みの契約がなければ利用できません。 |
コンテンツが表示される場所
スポットのカードのみ。 公開済み地図では、施設 コレクションのカードが、ガイドのレイアウトと同様に、カード自身の行の下に提供元のコンテンツを表示します。Kaleidr AI がそれを読んだり、引用したり、回答に使ったりすることはなく、コレクションに保存されることもありません。
どの事業者・会場か。 施設コレクションに公開列 yelp_id または ticketmaster_venue_id を追加すると、事業者や会場を正確に指定できます。指定がない場合、カードは Yelp ではスポットの位置にある同名の事業者を、Ticketmaster では 200 メートル以内の会場のイベントを探します。
表示のみ、お客様のキーで。 お客様の地図のための呼び出しには組織のキーだけを使い、お客様のキーが他の人の地図に使われることはありません。
キャッシュとクレジット表記
| 提供元 | コンテンツの最長保持期間 | クレジット表記 |
|---|---|---|
| Yelp | 6 時間 | Yelp の名前とロゴ、Yelp 上の事業者へのリンク |
| Ticketmaster | 1 時間 | Ticketmaster の名前とロゴ、各イベントへのリンク |
カードはこれらの上限の範囲内で更新され、訪問者のブラウザーはカードを最長 5 分間保持します。スポットと事業者や会場を対応付ける提供元独自の識別子は、両提供元の規約が認めるとおり、期限なく保持されます。
Ticketmaster はキーごとに 1 日の呼び出し回数を制限しています。お客様の地図のカードは、お客様のキーで 1 日最大 4,500 回まで呼び出し、上限に達すると翌日までイベントを表示しません。
Tripadvisor と Google Places を提供しない理由
- Tripadvisor のコンテンツは、Tripadvisor と署名したコンテンツ契約のもとでのみ表示できます。Studio のカードは Tripadvisor との署名済みコンテンツ契約が必要です と表示され、無効のままです。
- Google Places のコンテンツは Google の地図上でのみ表示できます。Kaleidr の地図は Kaleidr 独自のベースマップを描画するため、Google Places は提供していません。