자동 완성 및 세션 가격
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google에서는 자동 완성 (신규)과 함께 세션을 사용하는 것이 좋습니다.
세션을 사용하면 가격을 간소화하고 자동 완성 (신규)과 함께 사용할 수 있는 일관된 가격 책정 모델을 제공할 수 있습니다.
세션은 세션 토큰을 포함하는 첫 번째 Autocomplete (New) 요청으로 시작하여 후속 Autocomplete (New) 요청을 통해 계속되고 세션 토큰을 사용하는 Place Details (New) 또는 Address Validation 요청에 의해 종료됩니다.
세션이 종료된 후 만료된 세션 토큰을 사용하는 Autocomplete (New), Place Details (New) 또는 Address Validation에 대한 호출은 세션 토큰이 없는 것처럼 청구됩니다.
Place Details (New) 또는 Address Validation 요청으로 종료되지 않은 세션과 같은 불완전한 세션의 경우 SKU: Autocomplete Requests를 사용하는 Autocomplete (New) 요청에 대해서만 요금이 청구됩니다.
세션 결제
Place Details (New) Essentials 요청으로 종료되는 세션
SKU: Places API Place Details Essentials의 필드를 사용하는 요청으로 종료되는 Autocomplete (New) 세션의 경우:
Address Validation 또는 Place Details (New) (비필수) 요청으로 종료되는 세션
Place Details Pro, Enterprise 또는 Enterprise + Atmosphere의 필드를 사용하여 주소 유효성 검사 요청 또는 Place Details (New) 요청으로 종료되는 Autocomplete (New) 세션의 경우:
-
Autocomplete (New) 요청: 모든 Autocomplete (New) 요청은 SKU: Autocomplete Session Usage에 따라 요금이 청구되므로 이러한 요청에는 요금이 청구되지 않습니다.
-
Place Details (신규) 또는 Address Validation 요청: 적절한 SKU로 종료 요청에 대한 요금도 청구됩니다.
세션 가격 책정 시나리오
가장 일반적인 세 가지 세션 가격 책정 시나리오는 다음과 같습니다.
다음 섹션에서는 각 시나리오의 개별 청구 요금을 설명합니다.
위치 데이터 자동 완성
위치 데이터 자동 완성 시나리오에서는 Autocomplete (New) 및 Place Details (New)를 사용하여 장소에 관한 위치 정보를 가져오는 데 관심이 있습니다. 예를 들어 Autocomplete (New)에서 추천을 선택한 다음 Place Details (New)를 사용하여 장소의 위도 및 경도 좌표를 가져와 지도에 해당 장소를 표시합니다.
위치 정보에는 다음이 포함될 수 있습니다.
- 주소
- 위도 및 경도 좌표로 표시된 위치
- Plus Code
- 유형
- 표시 영역
이 세션은 SKU: Place Details Essentials에 의해 정의된 필드를 요청하는 Place Details (New)에 대한 단일 요청에 의해 종료됩니다.
다음과 같이 요금이 청구됩니다.
장소 검색 자동 완성
장소 탐색을 위한 Autocomplete 시나리오에서는 장소에 관한 위치 데이터 이상의 정보를 얻는 데 관심이 있습니다. 예를 들어 다음과 같은 요청을 할 수 있습니다.
- 접근성 옵션
- 현재 영업시간
- 주차 옵션
- 리뷰
- 평점
이 시나리오에서는 Place Details (New) Pro, Enterprise 또는 Enterprise + Atmosphere SKU에 포함된 필드를 요청하는 Place Details (New)에 대한 단일 요청으로 세션이 종료됩니다.
다음과 같이 요금이 청구됩니다.
결제 및 배송 자동 완성
Address Validation API는 주소를 허용하는 서비스입니다. 주소 구성요소를 식별하고 유효성을 검사합니다. 또한 우편 주소를 표준화하고 가장 잘 알려진 위도 및 경도 좌표를 찾습니다.
결제 및 배송 시 자동 완성 시나리오에서는 선택한 주소를 검증하기 위해 Address Validation API에 대한 요청으로 세션을 종료합니다.
다음과 같이 요금이 청구됩니다.
세션이 없는 가격
세션을 사용하지 않으면 SKU: Autocomplete Requests를 사용하여 Autocomplete (New)에 대한 요청별로 요금이 청구됩니다.
불완전하거나 포기한 세션의 가격
세션이 포기된 경우(Place Details(New) 또는 Address Validation 호출로 종료되지 않음) Autocomplete(New) 요청은 요청별 가격 모델로 되돌아가며 SKU: Autocomplete Requests에 따라 요금이 청구됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eGoogle recommends using sessions with Place Autocomplete for simplified and consistent pricing.\u003c/p\u003e\n"],["\u003cp\u003eSessions are initiated with the first Autocomplete request containing a session token and terminated by a Place Details request using the same token.\u003c/p\u003e\n"],["\u003cp\u003eSessions enable discounted pricing for Autocomplete requests after the initial few and are billed differently based on the type of Place Details request terminating them (Location data, Place discovery, or Checkout and delivery).\u003c/p\u003e\n"],["\u003cp\u003eIf sessions are not used or are incomplete (not terminated by a Place Details request), Autocomplete requests are billed individually at a standard rate.\u003c/p\u003e\n"],["\u003cp\u003eSessions cannot be shared between Places API endpoints and Places API (New) endpoints, limiting their use to specific sequences of requests within the same API version.\u003c/p\u003e\n"]]],[],null,["# Autocomplete and session pricing\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/session-pricing \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/session-pricing \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/session-pricing \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/session-pricing \"View this page for the Web Service platform docs.\") \n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n\nGoogle recommends that you use sessions with [Autocomplete (New)](/maps/documentation/javascript/place-autocomplete).\nSessions help simplify pricing and provide a consistent pricing model for use with Autocomplete (New).\n\n\nA session starts with the first Autocomplete (New) request that includes a session token,\ncontinues through each subsequent Autocomplete (New) request, and is then terminated by a request\nto Place Details (New) or Address Validation that uses the session token.\n\n\nAfter the session terminates, any call to Autocomplete (New), Place Details (New), or Address\nValidation that uses the expired session token is billed as if there was no session token.\n\n\nIncomplete sessions, meaning sessions that are not terminated by a request to Place Details (New)\nor Address Validation, are billed only for the Autocomplete (New) requests using the\n[SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n\nSession billing\n---------------\n\n### Sessions terminating in a Place Details (New) Essentials request\n\nFor Autocomplete (New) sessions that terminate in a request using fields from\n[SKU: Places API Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku):\n\n- **First 12 Autocomplete (New) requests** : You are billed for each Autocomplete (New) request, up to a maximum of 12 requests, using the [SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n- **For Autocomplete (New) requests 13 and higher in the same session** : You are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **Place Details (New) Essentials:** You are also billed for the terminating request at [SKU: Places API Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku).\n\n| **Note:** If you terminate the session by making a request to Place Details (New) using the [SKU: Places API Place Details Essentials (IDs Only)](/maps/billing-and-pricing/sku-details#place-details-id-only-ess-sku), then all requests to Autocomplete (New) are billed using the [SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku), as if you did not use sessions. This is because the request using the [SKU: Places API Place Details Essentials (IDs Only)](/maps/billing-and-pricing/sku-details#place-details-id-only-ess-sku) is not charged, so all Autocomplete (New) requests revert to per-request pricing.\n\n### Sessions terminating in Address Validation or Place Details (New) (non-Essentials) requests\n\nFor Autocomplete (New) sessions that terminate in an Address Validation request or a Place\nDetails (New) request using fields from Place Details\n[Pro](/maps/billing-and-pricing/sku-details#place-details-pro-sku),\n[Enterprise](/maps/billing-and-pricing/sku-details#place-details-ent-sku),\nor [Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku):\n\n- **Autocomplete (New) requests:** All Autocomplete (New) requests are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **Place Details (New) or Address Validation request:** You are also billed for the terminating request at the appropriate SKU:\n - **Place Details (New)** terminating requests are billed at [SKU: Place Details Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku), regardless of the fields requested.\n - **Address Validation** terminating requests are billed at [SKU: Address Validation Enterprise](/maps/billing-and-pricing/sku-details#address-validation-ent-sku).\n\nSession pricing scenarios\n-------------------------\n\nThe three most common session pricing scenarios are:\n\n- [Autocomplete for location data](#ac-location-data)\n- [Autocomplete for place discovery](#ac-place-discovery)\n- [Autocomplete for checkout and delivery](#ac-checkout-delivery)\n\nThe following sections describe the individual billing charges for each scenario.\n\n### Autocomplete for location data\n\n\nIn the Autocomplete for location data scenario, you are interested in using Autocomplete (New) and\nPlace Details (New) to obtain location information about a place. For example, you select a\nsuggestion from Autocomplete (New), then use Place Details (New) to get the place's latitude and\nlongitude coordinates to show that place on a map.\n\nLocation information can include the following:\n\n- Address\n- Location as latitude and longitude coordinates\n- Plus Code\n- Types\n- Viewport\n\n\nThis session is terminated by a single request to Place Details (New) that requests fields\ndefined by the\n[SKU: Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku).\n\nYou are then billed as follows:\n\n- **The first 12 Autocomplete (New) requests** are billed at the [SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n- **Any remaining Autocomplete (New) requests** are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **The terminating Place Details (New) request** is charged at the [SKU: Places API Place Details Essentials](/maps/billing-and-pricing/sku-details#place-details-ess-sku).\n\n### Autocomplete for place discovery\n\n\nIn the Autocomplete for place discovery scenario, you are interested in obtaining more than just\nlocation data about a place. For example, you might request any of the following:\n\n- Accessibility options\n- Current opening hours\n- Parking options\n- Reviews\n- Ratings\n\n\nFor this scenario, your session is terminated by a single request to Place Details (New) that\nrequests **any fields** included in the Place Details (New)\n[Pro](/maps/billing-and-pricing/sku-details#place-details-pro-sku),\n[Enterprise](/maps/billing-and-pricing/sku-details#place-details-ent-sku), or\n[Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku) SKUs.\n\nYou are then billed as follows:\n\n- **All Autocomplete (New) requests** are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **The terminating Place Details (New) request** is billed at [SKU: Places API Place Details Enterprise + Atmosphere](/maps/billing-and-pricing/sku-details#place-details-ent-plus-sku).\n\n### Autocomplete for checkout and delivery\n\n\nThe [Address Validation API](/maps/documentation/address-validation/overview) is a\nservice that accepts an address. It identifies address components and validates them. It also\nstandardizes the address for mailing and finds the best known latitude and longitude coordinates\nfor it.\n\n\nIn the Autocomplete for checkout and delivery scenario, you terminate the session with a request\nto the\n[Address Validation API](/maps/documentation/address-validation/requests-validate-address)\nto validate the selected address.\n\nYou are then billed as follows:\n\n- **All Autocomplete (New) requests** are billed at the [SKU: Autocomplete Session Usage](/maps/billing-and-pricing/sku-details#autocomplete-session-new-ess-sku), meaning there is no charge for those requests.\n- **An optional Place Details Essentials request** is billed at no charge, if requested before the terminating Address Validation request.\n- **The terminating Address Validation request** is billed at the [SKU: Address Validation Enterprise](/maps/billing-and-pricing/sku-details#address-validation-ent-sku).\n\nPricing without sessions\n------------------------\n\n\nIf you don't use sessions, you are billed per request to Autocomplete (New) using the\n[SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku).\n\nPricing for incomplete or abandoned sessions\n--------------------------------------------\n\n\nIf a session is abandoned, meaning not terminated by a call to Place Details (New) or Address\nValidation, Autocomplete (New) requests revert to the per-request pricing model and are billed\nper the\n[SKU: Autocomplete Requests](/maps/billing-and-pricing/sku-details#places_autocomplete-request-new-ess-sku)."]]
