Places API (신규) 및 Places API는 사용한 만큼만 지불하는 가격 모델을 사용합니다.
Places API (신규) 및 Places API 요청은 여러 SKU에 대한 호출을 생성합니다.
전체 Google 이용약관과 함께 Places API와 관련된 사용량 한도가 적용됩니다.
Google Cloud 콘솔에서 제공되는 도구를 사용하여 비용 및 사용량을 관리하세요.
Places API 요금 청구 방식
Places API (신규) 및 Places API는 사용한 만큼만 지불하는 가격 모델을 사용합니다.
Google Maps Platform API 및 SDK는 SKU를 기준으로 청구됩니다. 사용량은 각 SKU에 따라 추적되며 모든 API 또는 SDK에 둘 이상의
제품 SKU가 있을 수 있습니다. 비용은 다음과 같이 계산됩니다.
SKU 사용량 × 사용당 가격
가격 및 사용량 계산기를 사용하여 API 또는 SDK당 사용량 비용을 예측할 수 있습니다. 조건을 충족하는 Google Maps Platform SKU에 대해 결제 계정마다 매월 미화 200달러의 Google Maps Platform 크레딧이 제공됩니다. 이 크레딧은 대상 SKU에 자동으로 적용됩니다.
Places API (신규) 가격
필드 마스크에 관한 정보
Place Details (New), Nearby Search (New) 및 Text Search (New)의 경우 API 요청에서 FieldMask 헤더를 사용하여 응답에서 반환할 필드의 목록을 지정하세요. 요청에 적용할 수 있는 가장 높은 수준의 SKU가 청구됩니다. 즉 (Basic) SKU와 (Advanced) SKU 필드를 모두 선택하면 (Advanced) SKU를 기반으로 요금이 청구됩니다.
필드 마스크를 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.
자동 완성 (신규) 세션 정보
Autocomplete (신규) 세션에는 하나 이상의 Autocomplete (신규) 요청과 Place Details (신규) 요청 또는 Address Validation 요청이 포함됩니다. 동일한 세션 토큰이 Autocomplete (신규) 요청 및 후속 Place Details (신규) 요청 또는 Address Validation 요청에 전달됩니다.
세션은 첫 번째 Autocomplete (신규) 요청으로 시작됩니다. 그런 다음 사용자가 Autocomplete (신규) 추천 검색어 중 하나를 선택하면 장소 세부정보 (신규) 요청 또는 주소 유효성 검사 요청이 이루어집니다. 세션이 중단된 경우(즉, Place Details(New) 요청 또는 주소 유효성 검사 요청이 이루어지지 않은 경우) Autocomplete(New) 요청에 대해 세션 토큰이 제공되지 않은 것처럼 요금이 청구됩니다.
사용자가 장소를 선택한 후 (즉, 장소 세부정보 (신규) 요청 또는 주소 유효성 검사 요청이 이루어진 후) 새 세션 토큰을 사용하여 새 세션을 시작해야 합니다.
세션 토큰은 하나의 세션에 유효하며 두 개 이상의 세션에 사용할 수 없습니다. 세션 토큰을 재사용하면 세션이 유효하지 않은 것으로 간주되어 세션 토큰이 제공되지 않은 것처럼 요청에 대해 요금이 청구됩니다.
SKU: Autocomplete Requests
Autocomplete Requests SKU는 세션 토큰이 포함되지 않은 Autocomplete (New) API의 각 요청에 대해 요금이 청구됩니다.
세션 토큰을 사용하고 다음 중 하나에 해당하는 경우에도 요금이 청구됩니다.
SKU: Place Details (Location Only)로 정의된 필드를 요청하는 Place Details (New)에 대한 단일 요청으로 세션을 종료합니다.
최대 12개의 자동 완성 (신규) 요청에 대해 SKU: Autocomplete Requests를 사용하여 요금이 청구됩니다.
이후의 각 자동 완성 (신규) 요청에는 SKU: 자동 완성 세션 사용량이 사용되어 요금이 청구됩니다.
SKU: Place Details (IDs Only)를 호출하여 세션을 포기하거나 종료합니다. 그러면 모든 Autocomplete (New) 요청에 대해 SKU: Autocomplete Requests를 사용하여 요금이 청구됩니다.
*googleMapsLinks 필드는 GA 이전 미리보기 단계에 있으며 요금이 청구되지 않으므로 미리보기 기간 동안 사용 시 청구 금액은 0달러입니다.
SKU: Place Details (Basic, Advanced, Preferred)에서 모든 필드를 요청하는 Place Details 호출에 의해 자동 완성 세션이 종료되면 SKU: Place Details (Preferred)로 요금이 청구됩니다. 자세한 내용은 SKU: 자동 완성 세션 사용량을 참고하세요.
SKU: Place Details (Basic, Advanced, Preferred)에서 모든 필드를 요청하는 Place Details 호출에 의해 자동 완성 세션이 종료되면 SKU: Place Details (Preferred)로 요금이 청구됩니다. 자세한 내용은 SKU: 자동 완성 세션 사용량을 참고하세요.
SKU: Place Details (Basic, Advanced, Preferred)에서 모든 필드를 요청하는 Place Details 호출에 의해 자동 완성 세션이 종료되면 SKU: Place Details (Preferred)로 요금이 청구됩니다. 자세한 내용은 SKU: 자동 완성 세션 사용량을 참고하세요.
자동 완성 세션에는 사용자가 장소를 입력함과 동시에 추천 검색어를 가져오기 위한 Autocomplete 요청 및 사용자가 선택한 장소에 대한 세부정보를 가져오기 위한 최대 1개의 Place Details 요청이 포함됩니다. 동일한 세션 토큰이 Autocomplete 및 이후의 Place Detail 요청에 전달됩니다. 세션은 첫 번째 Autocomplete 요청으로 시작됩니다. 이 요청은 일반적으로 사용자가 입력을 시작할 때 발생합니다. 사용자가 Autocomplete 추천 검색어 중 하나를 선택하면 Place Details 호출이 이루어집니다. 사용자가 추천 검색어를 선택하지 않으면 Place Details 호출이 이루어지지 않습니다.
사용자가 장소를 선택한 후 (즉, Place Details 호출이 이루어진 후) 새 세션 토큰을 사용하여 새 세션을 시작해야 합니다.
iOS: 각 fetchPlaceFromPlaceID: 또는 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 호출
웹 서비스: 요청에 지정된 필드에 따라 각 장소 요청
데이터 SKU는 항상 데이터 SKU를 트리거하는 기본 SKU 외에 추가로 요금이 청구됩니다. 예를 들어 Basic Data 필드가 포함된 Place Details 요청에 대해서는 Basic Data SKU 및 Place Details SKU 모두에 따라 요금이 청구됩니다.
웹 서비스의 경우 다음 Places API 호출에서는 반환할 데이터 필드를 지정할 수 있습니다.
Place Details 또는 Find Place 요청에 필드 매개변수를 사용하여 지정된 필드로만 응답을 제한할 수 있습니다. Basic 카테고리의 필드는 장소 요청의 기본 비용에 포함되며 추가 요금이 발생하지 않습니다. 다음 필드 중 하나가 요청되면 Basic Data SKU가 트리거됩니다.
웹 서비스의 경우 Place Details 또는 Find Place 요청, Android 또는 iOS의 경우 Place.Field의 배열에 필드 매개변수를 사용하여 지정된 필드로만 응답을 제한할 수 있습니다. Contact 카테고리에 필드를 포함하면 추가 요금이 발생합니다. 다음 필드 중 하나가 요청되면 Contact Data SKU가 트리거됩니다.
Place Details 또는 Find Place 요청에 필드 매개변수를 사용하여 지정된 필드로만 응답을 제한할 수 있습니다. Atmosphere 카테고리에 필드를 포함하면 추가 요금이 발생합니다. 다음 필드 중 하나가 요청되면 Atmosphere Data SKU가 트리거됩니다.
잘못된 자동 완성 세션(예: 세션 토큰을 재사용하는 세션)에서 이루어진 호출에도 Autocomplete – Per Request SKU 요금이 청구됩니다.
Maps JavaScript API의 Place Autocomplete 위젯의 Autocomplete 요청에는 잘못된 자동 완성 세션에서 호출이 이루어지는 경우 Autocomplete - Per Request SKU 요금이 청구될 수 있습니다. 이 문제는 사용자가 여러 주소를 입력하거나 위젯에 여러 주소를 복사/붙여넣기하고 항상 자동 완성 예상 검색어를 선택하지 않을 때 발생할 수 있습니다.
JavaScript:
Maps JavaScript API 장소 검색창 위젯: getPlaces()
사용자가 쿼리 (아이콘: 돋보기)가
아닌 장소 결과 (아이콘: 핀)를 선택한 후 메서드입니다 (여기에 나와 있음).
검색창 위젯의 결과에서 검색창에 '피자'를 입력하면 Pizza Autentico 옆에 핀 아이콘이 표시되어
검색어가 아닌 장소 결과임을 나타냅니다.
웹 API 및 서비스를 사용하면 세션 토큰 제공 여부와 관계없이 Place Details SKU에 요금이 청구됩니다.
Place Details 호출 또는 요청을 실행하면 호출 또는 요청에 지정된 필드에 따라 데이터 SKU(Basic, Contact 또는 Atmosphere)도 생성됩니다. Place Details 호출 또는 요청에 필드가 지정되지 않은 경우, 모든 데이터 SKU가 트리거되고 Place Details 호출 또는 요청에 대한 요금 및 모든 데이터의 비용이 청구됩니다.
예
다음 중 하나를 호출 또는 요청합니다.
모바일:fetchPlace()(Android) 또는 fetchPlaceFromPlaceID:(iOS)를 호출하고 ADDRESS 필드만 지정합니다.
웹 API 또는 서비스: Place Details를 요청하고 주소 필드만 지정합니다.
getPlaceDetails(fields: formatted_address)
Find Place 요청을 실행하면 요청에 지정된 필드에 따라 데이터 SKU(Basic, Contact, Atmosphere)도 생성됩니다. Place Details 요청과 마찬가지로 Find Place 요청의 필드 매개변수를 사용하여 지정된 필드로만 응답을 제한할 수 있습니다. Find Place 요청 및 요청된 데이터에 대해 요금이 청구됩니다. 기본적으로 필드가 요청되지 않으면 장소 ID만 반환되므로 추가 데이터 요금이 발생하지 않습니다.
예
Find Place를 요청하고 주소 필드만 지정합니다. FindPlace(fields: formatted_address). 청구서에 다음 SKU가 표시됩니다(SKU별로 청구서를 표시하는 경우).
Find Place(가격은 호출당 미화 0.017달러부터 시작함)
Basic Data(미화 0.00달러로 청구됨)
Find Place를 요청하고 전화번호 필드를 지정합니다. FindPlace(fields: formatted_phone_number). 청구서에 다음 SKU가 표시됩니다(SKU별로 청구서를 표시하는 경우).
Find Place(가격은 호출당 미화 0.017달러부터 시작함)
Contact Data(가격은 요청당 미화 0.003달러부터 시작함)
Find Place를 요청하고 세 가지 데이터 유형 버킷 모두에서 필드를 지정합니다. FindPlace(fields: formatted_address, opening_hours, price_level). 청구서에 다음 SKU가 표시됩니다(SKU별로 청구서를 표시하는 경우).
Find Place(가격은 호출당 미화 0.017달러부터 시작함)
Basic Data(미화 0.00달러로 청구됨)
Contact Data(가격은 요청당 미화 0.003달러부터 시작함)
Atmosphere Data(가격은 요청당 미화 0.005달러부터 시작함)
SKU: Find Place – ID only
Find Place - ID only는 반환될 장소 ID만 지정하는 Find Place 요청에 대해 요금이 청구됩니다. 기본적으로 Find Place 요청에 필드가 지정되지 않으면 장소 ID만 반환됩니다.
월간 사용량 범위 (호출당 가격)
0~100,000회
100,001~500,000회
500,000회 이상
미화 0.00달러
미화 0.00달러
미화 0.00달러
예
Find Place를 요청하고 place_id 필드만 지정합니다. FindPlace(fields: place_id).
청구서에 다음 SKU가 표시됩니다(SKU별로 청구서를 표시하는 경우).
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-01-29(UTC)"],[[["Google Places API uses a pay-as-you-go model with charges based on specific features (SKUs) used in requests."],["You receive a $200 monthly credit that automatically applies to eligible SKUs until February 28, 2025."],["Using field masks to specify only the data needed in your requests can help control costs."],["Autocomplete sessions, linking Autocomplete requests with Place Details or Address Validation requests, are currently free."],["Pricing varies by SKU and usage volume, with tiers adjusting based on the number of requests made per month."]]],[]]