연결
연결은 조직이 해당 제공업체에 가진 자체 계정으로, 게시된 지도의 장소 카드에 제공업체의 콘텐츠를 표시합니다. 시설의 Yelp 평점과 리뷰 수, 또는 공연장의 다가오는 Ticketmaster 이벤트를 보여 줄 수 있습니다. API 키는 직접 준비하며, 콘텐츠는 그 키에 적용되는 제공업체의 약관에 따라 표시됩니다.
| 제공업체 | 표시 내용 | 상태 |
|---|---|---|
| Yelp | 업체의 평점, 리뷰 수, 가격대, 카테고리와 Yelp 페이지 링크 | 제공 |
| Ticketmaster | 앞으로 14일 동안 해당 장소에서 열리는 이벤트 최대 5개와 각 이벤트의 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 이름과 로고, 각 이벤트 링크 |
카드는 이 한도 안에서 새로 고쳐지며, 방문자의 브라우저는 카드를 최대 5분 동안 보관합니다. 장소를 업체나 공연장과 연결하는 제공업체 자체 식별자는 두 제공업체의 약관이 허용하는 대로 기간 제한 없이 보관됩니다.
Ticketmaster는 키별로 하루 호출 횟수를 제한합니다. 내 지도의 카드는 내 키로 하루 최대 4,500회 호출하며, 이 횟수에 도달하면 다음 날까지 이벤트를 표시하지 않습니다.
Tripadvisor와 Google Places를 제공하지 않는 이유
- Tripadvisor 콘텐츠는 Tripadvisor와 서명한 콘텐츠 계약에 따라서만 표시할 수 있습니다. Studio의 카드는 Tripadvisor와 서명된 콘텐츠 계약 필요로 표시되며 비활성 상태로 유지됩니다.
- Google Places 콘텐츠는 Google 지도에서만 표시할 수 있습니다. Kaleidr 지도는 Kaleidr 자체 베이스맵을 그리므로 Google Places는 제공하지 않습니다.