Place Autocomplete와 함께 세션을 사용하는 것이 좋습니다. 세션은 가격 책정을 간소화하고 Place Autocomplete와 함께 사용할 일관된 가격 책정 모델을 제공하는 데 도움이 됩니다.
세션 가격은 세션 토큰이 포함된 첫 번째 장소 자동 완성 요청으로 시작하여 이후의 각 장소 자동 완성 요청을 통해 계속되고 세션 토큰을 사용하는 장소 세부정보 요청으로 종료됩니다.
세션이 종료된 후 만료된 세션 토큰을 사용하는 Place Autocomplete, Place Details (신규) 호출에는 세션 토큰이 없는 것처럼 요금이 청구됩니다.
Place Details 요청으로 종료되지 않은 세션을 의미하는 불완전한 세션에는 SKU: Autocomplete Requests를 사용하는 자동 완성 요청에 대해서만 요금이 청구됩니다.
가장 일반적인 세 가지 가격 책정 시나리오는 다음과 같습니다.
- 위치 데이터 자동 완성
- 장소 검색을 위한 자동 완성
- 결제 및 배송 자동 완성
위치 데이터 자동 완성
이 시나리오에서는 자동 완성과 장소 세부정보(신규)를 사용하여 장소에 관한 위치 정보를 얻는 방법을 알아봅니다. 예를 들어 자동 완성에서 제안을 선택한 다음 장소 세부정보를 사용하여 장소의 위도와 경도 좌표를 가져와 지도에 해당 장소를 표시할 수 있습니다.
위치 정보에는 장소의 다음 정보가 포함될 수 있습니다.
- 주소
- 위도 및 경도 좌표로 위치
- Plus Code
- 유형
- 표시 영역
이 세션은 SKU: Place Details (Location Only)로 정의된 필드를 요청하는 Place Details에 대한 단일 요청으로 종료됩니다.
그러면 다음과 같이 요금이 청구됩니다.
- SKU: Autocomplete Requests를 사용하여 최대 12개의 장소 자동 완성 요청
- 요청 1,000개당 $2.83, 최대 100,000개 요청까지 청구
- 요청 1,000개당 $2.27(최대 500,000개) 청구
- 활성 세션 중에 13개 이상의 Place Autocomplete 요청이 발생하면 SKU: Autocomplete Session Usage로 요금이 청구되므로 이러한 요청에 대해서는 요금이 청구되지 않습니다.
- SKU: Place Details (Location Only)를 사용하는 Place Details 요청 1회:
- 요청 1,000개당 $5.00의 요금이 최대 100,000개까지 청구됩니다.
- 요청 1,000개당 $4.00의 요금이 청구되며 최대 500,000개까지 요청할 수 있습니다.
장소 검색을 위한 자동 완성
장소 검색을 위한 자동 완성 시나리오에서는 장소에 대한 위치 데이터 외에도 더 많은 정보를 얻는 데 관심이 있습니다. 예를 들어 다음 중 하나를 요청할 수 있습니다.
- 접근성 옵션
- 현재 영업시간
- 주차 옵션
- 리뷰
- 평점
이 시나리오에서는 Place Details(신규) 요청으로 인해 세션이 종료됩니다. 이 요청은 Place Details Basic, Advanced 또는 Preferred SKU에 포함된 모든 필드를 요청합니다.
그러면 다음과 같이 요금이 청구됩니다.
- 모든 Place Autocomplete 요청에는 SKU: Autocomplete Session Usage로 요금이 청구되므로 이러한 요청에는 요금이 청구되지 않습니다.
- SKU: Place Details (Preferred) 요청 1개:
- 요청 1,000개당 $25.00(최대 100,000개)로 청구
- 요청 1,000개당 $20.00의 요금이 청구되며 최대 500,000개까지 요청할 수 있습니다.
가격 책정 예시
다음 표에는 세 가지 주요 세션 시나리오의 가격 예가 나와 있습니다. 이 표에는 각 시나리오의 결제 명세서에 표시되는 SKU도 나와 있습니다.
| 시나리오 | 요청 예 | 청구된 SKU | 가격 |
|---|---|---|---|
| 위치 데이터 |
|
|
|
| 장소 검색 |
|
|
|
| 결제 및 배송 |
|
|
세션이 없는 가격 책정 예시
세션을 사용하지 않으면 SKU: Autocomplete Requests를 사용하여 Place Autocomplete 요청별로 요금이 청구되며 요청 1, 000개당 2.83달러가 청구됩니다.
완료되지 않거나 중단된 세션의 대체 가격
세션이 중단된 경우(Place Details(신규) 호출로 종료되지 않음) Place Autocomplete 요청이 요청별 가격 책정 모델로 되돌아갑니다. 이 경우 SKU: Autocomplete Requests에 정의된 대로 요청 1,000개당 미화 2.83달러가 청구됩니다.