플랫폼 선택: Android iOS JavaScript 웹 서비스

세션 토큰

세션 토큰은 Autocomplete (신규) 호출을 세션으로 추적하는 사용자 생성 문자열 (또는 객체)입니다. Autocomplete (신규)는 세션 토큰을 사용하여 사용자 자동 완성 검색의 쿼리 및 선택 단계를 결제 목적의 개별 세션으로 그룹화합니다.

사용자는 각 세션의 세션 토큰을 만들어야 합니다. 세션 토큰은 URL 및 파일 이름 보안 base64 문자열이어야 합니다. 세션 토큰에는 버전 4 범용 고유 식별자 (UUID)를 사용하는 것이 좋지만 사용자는 어떤 방식으로든 세션 토큰을 생성할 수 있습니다.

세션은 Autocomplete (신규) 호출로 시작되고 Place Details (New) 또는 Address Validation 호출로 끝납니다. 각 세션에는 여러 개의 Autocomplete (신규) 쿼리가 포함될 수 있으며 이어서 Place Details(New) 또는 Address Validation에 대한 요청이 하나씩 있을 수 있습니다. 세션 내의 각 요청에 사용되는 API 키는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다.

세션 토큰은 다음과 같은 방식으로 종료됩니다.

  • Place Details (New)가 호출됩니다.
  • 주소 확인이 호출됩니다.
  • 세션이 포기되었습니다.

세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱은 새 세션마다 새 토큰을 생성해야 합니다. sessionToken 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 새 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).

Autocomplete (신규) 요청에 대한 요금 청구 방식에 관한 자세한 내용은 Autocomplete (신규) 및 세션 가격 책정을 참고하세요.