자동 완성(신규)을 사용하는 세션을 사용하는 것이 좋습니다. 세션은 가격 책정을 간소화하고 자동 완성 (신규)과 함께 사용할 수 있는 일관된 가격 책정 모델을 제공하는 데 도움이 됩니다.
세션 가격은 세션 토큰이 포함된 첫 번째 Autocomplete (New) 요청으로 시작하여 이후의 각 Autocomplete (New) 요청을 통해 계속되고 세션 토큰을 사용하는 Place Details (New) 또는 Address Validation 요청으로 종료됩니다.
세션이 종료된 후 만료된 세션 토큰을 사용하는 자동 완성 (신규), 장소 세부정보 (신규) 또는 주소 유효성 검사 호출에는 세션 토큰이 없는 것처럼 요금이 청구됩니다.
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회 이상의 자동 완성 (신규) 요청이 발생하면 SKU: Autocomplete Session Usage로 요금이 청구되므로 이러한 요청에는 요금이 청구되지 않습니다.
- SKU: Place Details (Location Only)를 사용하는 Place Details 요청 1회:
- 요청 1,000개당 $5.00의 요금이 최대 100,000개까지 청구됩니다.
- 요청 1,000개당 $4.00(최대 500,000개 요청) 청구
장소 검색을 위한 자동 완성
장소 검색을 위한 Autocomplete 시나리오에서는 장소에 대한 위치 데이터 외에도 더 많은 정보를 얻는 데 관심이 있습니다. 예를 들어 다음 중 하나를 요청할 수 있습니다.
- 접근성 옵션
- 현재 영업시간
- 주차 옵션
- 리뷰
- 평점
이 시나리오에서는 Place Details(신규) 기본, 고급 또는 선호 SKU에 포함된 모든 필드를 요청하는 Place Details (신규) 요청으로 인해 세션이 종료됩니다.
그러면 다음과 같이 요금이 청구됩니다.
- 모든 Autocomplete (신규) 요청에는 SKU: Autocomplete Session Usage에 따라 요금이 청구되므로 이러한 요청에는 요금이 청구되지 않습니다.
- SKU: Place Details (Preferred) 요청 1개:
- 요청 1,000개당 $25.00(최대 100,000개)로 청구
- 요청 1,000개당 $20.00, 최대 500,000개 요청까지 청구
결제 및 배송 자동 완성
Address Validation API는 주소를 허용하는 서비스입니다. 주소 구성요소를 식별하고 유효성을 검사합니다. 또한 우편 발송용 주소를 표준화하고 가장 잘 알려진 위도 및 경도 좌표를 찾습니다.
결제 및 배송을 위한 자동 완성 시나리오에서 Address Validation API에 대한 요청으로 세션을 종료하여 선택한 주소를 확인합니다. 그러면 다음과 같이 요금이 청구됩니다.
- 모든 Autocomplete (신규) 요청에는 SKU: Autocomplete Session Usage에 따라 요금이 청구되므로 이러한 요청에는 요금이 청구되지 않습니다.
- SKU: Address Validation Preferred 요청 1회:
- 요청 1,000개당 $25.00(최대 100,000개)로 청구
- 요청 1,000개당 $20.00, 최대 500,000개 요청까지 청구
가격 책정 예시
다음 표에는 세 가지 기본 세션 시나리오의 가격 예시가 나와 있습니다. 이 표에는 각 시나리오의 결제 명세서에 표시되는 SKU도 나와 있습니다.
| 시나리오 | 요청 예 | 청구된 SKU | 요청 1,000건당 가격 |
|---|---|---|---|
| 위치 데이터 |
|
|
|
| 장소 검색 |
|
|
|
| 결제 및 배송 |
|
|
세션이 없는 가격 책정 예시
세션을 사용하지 않으면 SKU: Autocomplete Requests를 사용하여 자동 완성 (신규) 요청별로 요금이 청구되며 요청 1, 000개당 2.83달러가 청구됩니다.
완료되지 않거나 중단된 세션의 대체 가격
세션이 중단된 경우(Place Details(신규) 또는 주소 유효성 검사 호출로 종료되지 않음) Autocomplete(신규) 요청이 요청별 가격 책정 모델로 되돌아갑니다. 이 경우 SKU: Autocomplete Requests에 정의된 대로 요청 1,000개당 미화 2.83달러가 청구됩니다.