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