세션 토큰은 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.
세션 토큰 만들기
사용자는 각 세션에 대해 고유한 세션 토큰을 생성할 책임이 있습니다. 버전 4 UUID를 사용하는 것이 좋습니다.
예
사용자가 검색어를 입력하면 문자별이 아닌 몇 번의 키 입력마다 자동 완성 요청이 호출되고 가능한 결과 목록이 반환됩니다. 사용자가 결과 목록에서 항목을 선택하면 선택사항이 요청으로 집계되고 검색 중에 이루어진 모든 요청이 번들로 묶여 단일 요청으로 집계됩니다. 사용자가 장소를 선택하면 검색어는 무료로 사용할 수 있으며 장소 데이터 요청에 대해서만 요금이 청구됩니다. 사용자가 세션이 시작된 후 몇 분 이내에 선택하지 않으면 검색어 요금만 청구됩니다.
앱의 관점에서 이 이벤트 흐름을 살펴보겠습니다.
- 사용자가 '프랑스 파리'를 검색하기 위해 검색어를 입력하기 시작합니다.
- 사용자 입력을 감지하면 앱은 새 세션 토큰 '토큰 A'를 만듭니다.
- 사용자가 입력하면 API는 몇 자마다 자동 완성 요청을 실행하여 각 문자에 대해 가능한 결과의 새 목록을 표시합니다.
"P"
"Par"
"Paris,"
"Paris, Fr"
- 사용자가 선택하면 다음과 같이 처리됩니다.
- 쿼리에서 발생한 모든 요청은 그룹화되어 '토큰 A'로 표시된 세션에 단일 요청으로 추가됩니다.
- 사용자의 선택사항은 장소 세부정보 요청으로 집계되고 '토큰 A'로 표시된 세션에 추가됩니다.
- 세션이 종료되고 앱에서 '토큰 A'를 삭제합니다.
자동 완성 요청에 대한 요금 청구 방식에 관한 자세한 내용은 사용량 및 결제를 참고하세요.