Places API 사용량 및 결제

Places API의 결제 및 가격 책정

Google에서 결제 및 가격을 계산하는 방법에 대한 자세한 내용은 Google Maps Platform 가격 목록 또는 Google Maps Platform 가격 목록 - 인도를 참고하세요.

Places (New) product SKU

정보 정보 아이콘을 클릭하여 이 페이지의 목차를 확인합니다. 다음 섹션에서는 각 SKU의 세부정보를 간략하게 설명합니다.

카테고리 SKU가 Essentials, Pro 또는 Enterprise SKU 카테고리에 속하는지 여부입니다.
청구 가능 이벤트 SKU에 대해 청구되는 이벤트입니다.
트리거 청구 가능한 이벤트를 트리거하는 코드 요소
가격 책정 해당 SKU 그룹의 가격표 링크입니다.

필드 마스크에 관한 정보

Place Details (New), Nearby Search (New) 및 Text Search (New)의 경우 API 요청에서 FieldMask 헤더를 사용하여 응답에서 반환할 필드의 목록을 지정하세요. 요청에 적용할 수 있는 가장 높은 수준의 SKU가 청구됩니다. 즉 Essentials SKU와 Pro SKU 필드를 모두 선택하면 Pro SKU를 기반으로 요금이 청구됩니다.

필드 마스크를 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.

자동 완성 (신규) 세션 정보

Autocomplete (신규) 세션에는 하나 이상의 Autocomplete (신규) 요청과 Place Details (신규) 요청 또는 Address Validation 요청이 포함됩니다. 동일한 세션 토큰이 Autocomplete (신규) 요청 및 후속 Place Details (신규) 요청 또는 Address Validation 요청에 전달됩니다.

세션은 첫 번째 Autocomplete (신규) 요청으로 시작됩니다. 그런 다음 사용자가 Autocomplete (신규) 추천 검색어 중 하나를 선택하면 장소 세부정보 (신규) 요청 또는 주소 유효성 검사 요청이 이루어집니다. 세션이 중단된 경우(즉, Place Details(New) 요청 또는 주소 유효성 검사 요청이 이루어지지 않은 경우) Autocomplete(New) 요청에 대해 세션 토큰이 제공되지 않은 것처럼 요금이 청구됩니다.

사용자가 장소를 선택한 후 (즉, 장소 세부정보 (신규) 요청 또는 주소 유효성 검사 요청이 이루어진 후) 새 세션 토큰을 사용하여 새 세션을 시작해야 합니다.

세션 토큰은 하나의 세션에 유효하며 두 개 이상의 세션에 사용할 수 없습니다. 세션 토큰을 재사용하면 세션이 유효하지 않은 것으로 간주되어 세션 토큰이 제공되지 않은 것처럼 요청에 대해 요금이 청구됩니다.

SKU: Autocomplete Requests

이 SKU는 세션을 사용하지 않는 Autocomplete API 요청에 대해 요금이 청구됩니다. 세션을 사용하여 단일 자동 완성 세션 중에 청구되는 요청 수를 제한하는 방법에 관한 자세한 내용은 세션 토큰 또는 SKU: 자동 완성 세션 사용량을 참고하세요.

  카테고리 Essentials
  청구 가능 이벤트 요청
  트리거

이 SKU는 다음과 같은 조건에서 트리거됩니다.

  • 요청에 세션 토큰이 포함되어 있지 않습니다.
  • 요청에 세션 토큰이 포함되어 있지만 세션을 포기합니다.
  • 요청에 세션 토큰이 포함되어 있지만 특정 조건에서 세션을 종료합니다. 자동 완성 세션 사용량에 관한 자세한 내용은 세션 토큰 또는 자동 완성 세션 사용량을 참고하세요.
  가격 책정 기본 가격표
인도 가격표

SKU: Autocomplete Session Usage

이 SKU는 세션 토큰이 포함된 Autocomplete (New) API의 각 요청에 대해 요금이 청구됩니다.

  카테고리 Essentials
  청구 가능 이벤트 요청
  트리거

이 SKU는 세션 토큰이 포함된 Autocomplete (New) API에 요청을 전송할 때 트리거됩니다.

이 SKU는 단일 자동 완성 세션 중에 청구되는 요청 수를 제한하는 방법을 제공하는 자동 완성 (신규) 요청 SKU의 래퍼 역할을 합니다. 자동 완성 세션 사용량에 관한 자세한 내용은 세션 토큰을 참고하세요.

참고: 자동 완성 (신규)에서 세션을 사용하지 않으면 SKU: Autocomplete Requests를 사용하여 자동 완성 요청별로 요금이 청구됩니다.

자세한 내용은 자동 완성 (신규) 및 세션 가격 책정을 참고하세요.

  가격 책정 기본 가격표
인도 가격표

SKU: Places API Place Details Essentials(장소 세부정보 기본 요소)(ID만 해당)

이 SKU는 장소 ID만 반환하는 장소 세부정보 요청에 대해 요금이 청구됩니다.

  카테고리 Essentials
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거

이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    attributions
    id
    name*
    photos

    * name 필드에는 장소 리소스 이름이 places/PLACE_ID 형식으로 포함됩니다. displayName을 사용하여 장소의 텍스트 이름에 액세스합니다.
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Place Details Essentials

이 SKU는 이 SKU의 필드를 가져오는 Place Details API 요청에 대해 요금을 청구합니다.
  카테고리 Essentials
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거

이 SKU는 다음 위치 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    shortFormattedAddress
    types
    viewport

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Place Details Pro

이 SKU는 장소 세부정보 Pro 요청에서 지정하는 필드에 대해 요금이 청구됩니다.

  카테고리 Pro
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 이 SKU는 다음 필드 또는 요금이 더 낮은 필드를 요청하는 경우에만 트리거됩니다.

  • 웹 서비스:
    accessibilityOptions
    businessStatus
    containingPlaces
    displayName
    googleMapsLinks*
    googleMapsUri
    iconBackgroundColor
    iconMaskBaseUri
    primaryType
    primaryTypeDisplayName
    pureServiceAreaBusiness
    subDestinations
    utcOffsetMinutes

    * googleMapsLinks 필드는 GA 이전 미리보기 단계에 있으며 미리보기 기간 동안 사용에 대한 요금이 청구되지 않으므로 결제 금액은 0달러입니다.

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Place Details Enterprise

이 SKU는 Enterprise 필드가 포함된 장소 요청에 대해 요금이 청구됩니다.

  카테고리 Enterprise
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스: currentOpeningHours
    currentSecondaryOpeningHours
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    priceRange
    rating
    regularOpeningHours
    regularSecondaryOpeningHours
    userRatingCount
    websiteUri

SKU: Place Details (Basic, Advanced, Preferred)에서 모든 필드를 요청하는 Place Details 호출로 자동 완성 세션을 종료하면 SKU: Place Details (Preferred)로 호출에 대해 요금이 청구됩니다. 자세한 내용은 SKU: 자동 완성 세션 사용량을 참고하세요.
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Place Details Enterprise + Atmosphere

이 SKU는 지정된 분위기 필드를 요청하는 Place Details API 호출에 대해 요금을 청구합니다.

  카테고리 Enterprise
  청구 가능 이벤트 요청
  트리거

이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    allowsDogs
    curbsidePickup
    delivery
    dineIn
    editorialSummary
    evChargeOptions
    fuelOptions
    goodForChildren
    goodForGroups
    goodForWatchingSports
    liveMusic
    menuForChildren
    parkingOptions
    paymentOptions
    outdoorSeating
    reservable
    restroom
    reviews
    routingSummaries*
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine
    takeout

    * 텍스트 검색 및 주변 검색만 해당

SKU: Place Details (Basic, Advanced, Preferred)에서 모든 필드를 요청하는 Place Details 호출로 인해 자동 완성 세션이 종료되면 SKU: Place Details (Preferred)로 요금이 청구됩니다. 자세한 내용은 SKU: 자동 완성 세션 사용량을 참고하세요.
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Nearby Search Pro

이 SKU는 Nearby Search Pro 요청에서 지정하는 필드에 대해 요금이 청구됩니다.

  카테고리 Pro
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 이 SKU는 다음 필드 또는 요금이 더 낮은 필드를 요청하는 경우에만 트리거됩니다.

  • 웹 서비스:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.attributions
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.id
    places.location
    places.name**
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * places.googleMapsLinks 필드는 GA 이전 미리보기 단계에 있으며 요금이 청구되지 않으므로 미리보기 기간 동안 사용 시 청구 금액은 0달러입니다.

    ** places.name 필드에 리소스 이름 장소가 places/PLACE_ID 형식으로 포함됩니다. places.displayName을 사용하여 장소의 텍스트 이름에 액세스합니다.

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Nearby Search Enterprise

이 SKU는 Enterprise 필드가 포함된 Nearby Search 요청에 대해 요금을 청구합니다.

  카테고리 Enterprise
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거

이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Nearby Search Enterprise + Atmosphere

이 SKU는 지정된 분위기 필드가 포함된 주변 검색 요청에 대해 청구됩니다.

  카테고리 Enterprise
  청구 가능 이벤트 요청
  트리거

이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * 텍스트 검색 및 주변 검색만 해당
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Text Search Essentials (ID만 해당)

이 SKU는 ID만 반환하는 Text Search API 요청에 대해 요금이 청구됩니다.
  카테고리 Essentials
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거

이 SKU는 다음 필드를 요청하는 경우에만 트리거됩니다.

  • 웹 서비스:
    places.attributions
    places.id
    places.name*
    nextPageToken

    * places.name 필드에는 장소 리소스 이름이 places/PLACE_ID 형식으로 포함됩니다. places.displayName을 사용하여 장소의 텍스트 이름에 액세스합니다.

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Text Search Pro

이 SKU는 Text Search Pro 요청에 지정된 필드에 대해 요금이 청구되는 데이터 SKU입니다.
  카테고리 Pro
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 이 SKU는 다음 필드 또는 요금이 더 낮은 필드를 요청하는 경우에만 트리거됩니다.

  • 웹 서비스:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.location
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * places.googleMapsLinks 필드는 GA 이전 미리보기 단계에 있으며 요금이 청구되지 않습니다. 즉, 미리보기 기간 동안 사용 시 청구 금액은 0달러입니다.

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Text Search Enterprise

이 SKU는 Enterprise 필드가 포함된 텍스트 검색 요청에 대해 요금이 청구됩니다.

  카테고리 Enterprise
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Text Search Enterprise + Atmosphere

이 SKU는 대기 필드가 포함된 텍스트 검색 요청에 대해 요금이 청구됩니다.

  카테고리 Enterprise
  청구 가능 이벤트 요청
  트리거 이 SKU는 다음 필드를 요청할 때 트리거됩니다.

  • 웹 서비스:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * 텍스트 검색 및 주변 검색만 해당

  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Place Details Photos

이 SKU는 장소 세부정보 사진 요청에 대해 요금이 청구됩니다.

  카테고리 Enterprise
  청구 가능 이벤트 요청
  트리거 Place Details API에서 사진을 요청하면 결제가 트리거됩니다.
  가격 책정 기본 가격표
인도 가격표

기존 Places 제품 SKU

자동 완성 세션에 대한 정보

자동 완성 세션에는 사용자가 장소를 입력함과 동시에 추천 검색어를 가져오기 위한 Autocomplete 요청 및 사용자가 선택한 장소에 대한 세부정보를 가져오기 위한 최대 1개의 Place Details 요청이 포함됩니다. 동일한 세션 토큰이 Autocomplete 및 이후의 Place Detail 요청에 전달됩니다. 세션은 첫 번째 Autocomplete 요청으로 시작됩니다. 이 요청은 일반적으로 사용자가 입력을 시작할 때 발생합니다. 사용자가 Autocomplete 추천 검색어 중 하나를 선택하면 Place Details 호출이 이루어집니다. 사용자가 추천 검색어를 선택하지 않으면 Place Details 호출이 이루어지지 않습니다.

사용자가 장소를 선택한 후 (즉, Place Details 호출이 이루어진 후) 새 세션 토큰을 사용하여 새 세션을 시작해야 합니다.

자동 완성 세션은 다음과 같은 API에서 생성할 수 있습니다.

세션 토큰은 하나의 사용자 세션에 유효하며 두 개 이상의 사용자 세션에 사용해서는 안 됩니다. 세션 토큰을 재사용하면 세션이 유효하지 않은 것으로 간주되어 세션 토큰이 제공되지 않은 것처럼 요청에 대해 요금이 청구됩니다.

세션을 사용하는 Autocomplete 요청 및 Place Details 요청에 대해서는 서로 다른 SKU에 따라 요금이 청구됩니다.

Places Data SKU에 대한 정보

세 Places Data SKU는 Basic Data, Contact Data, Atmosphere Data입니다.

다음에 대해 하나 이상의 데이터 SKU가 트리거됩니다.

  • Android: 각 fetchPlace() 또는 findCurrentPlace() 요청
  • iOS: 각 fetchPlaceFromPlaceID: 또는 findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: 호출
  • 웹 서비스: 요청에 지정된 필드에 따라 각 장소 요청

데이터 SKU는 항상 데이터 SKU를 트리거하는 기본 SKU 외에 추가로 요금이 청구됩니다. 예를 들어 Basic Data 필드가 포함된 Place Details 요청에 대해서는 Basic Data SKU 및 Place Details SKU 모두에 따라 요금이 청구됩니다.

웹 서비스의 경우 다음 Places API 요청을 사용하여 반환할 데이터 필드를 지정할 수 있습니다.

웹 서비스의 경우 다음 Places API 호출에서는 반환된 필드를 지정할 수 없습니다. 이 호출에서는 항상 모든 장소 데이터를 반환하고 각 API 요청에 대한 요금 외에 세 개의 Places Data SKU에 대해 요금을 청구합니다.

SKU: Basic Data

이 SKU는 Place Details 또는 장소 검색 요청의 기본 데이터 필드에 대해 요금이 청구되는 데이터 SKU입니다. 이 SKU는 요청을 트리거한 기본 SKU 외에 요금이 청구됩니다.

Basic 카테고리의 필드는 장소 요청의 기본 비용에 포함되며 추가 요금이 발생하지 않습니다.

  카테고리 Essentials
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 다음 필드 중 하나를 요청하면 Basic Data SKU가 트리거됩니다.
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.DISPLAY_NAME
    Place.Field.FORMATTED_ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.ID
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.TYPES
    Place.Field.VIEWPORT
    Place.Field.UTC_OFFSET
  • iOS:
    GMSPlaceFieldFormattedAddress
    GMSPlaceFieldBusinessStatus
    GMSPlaceFieldID
    GMSPlaceFieldCoordinate
    GMSPlaceFieldName
    GMSPlaceFieldPhotos
    GMSPlaceFieldPlusCode
    GMSPlaceFieldTypes
    GMSPlaceFieldViewport
  • 웹 서비스:
    address_component
    adr_address
    business_status
    formatted_address
    geometry
    icon
    name
    permanently_closed
    photo
    place_id
    plus_code
    type
    url
    utc_offset
    vicinity
    wheelchair_accessible_entrance
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Contact Data

이 SKU는 Place Details 또는 Find Place 요청의 Contact Data 필드에 대해 요금이 청구되는 데이터 SKU입니다. 이 SKU는 요청을 트리거한 기본 SKU 외에 요금이 청구됩니다.

웹 서비스의 경우 Place Details 또는 Find Place 요청, Android 또는 iOS의 경우 Place.Field의 배열에 필드 매개변수를 사용하여 지정된 필드로만 응답을 제한할 수 있습니다. Contact 카테고리에 필드를 포함하면 추가 요금이 발생합니다.

  카테고리 Enterprise
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 다음 필드 중 하나가 요청되면 Contact Data SKU가 트리거됩니다.
  • Android: Place.Field.CURRENT_OPENING_HOURS, Place.Field.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours, GMSPlaceFieldPhoneNumber, GMSPlaceFieldWebsite
  • 웹 서비스: formatted_phone_number, international_phone_number, opening_hours, current_opening_hours, secondary_opening_hours 또는 website
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Atmosphere Data

이 SKU는 이 SKU의 필드를 지정하는 Atmosphere Data API 요청에 대해 요금을 청구합니다.

  카테고리 Enterprise
  청구 가능 이벤트 지정된 필드 마스크를 사용하여 요청합니다.
  트리거 다음 필드 중 하나를 요청하면 결제가 트리거됩니다.
Android
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.RESERVABLE
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT

iOS

GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.

자바스크립트

필드 (장소 세부정보)
curbside_pickup
delivery
dine_in, editorial_summary
price_level
rating
reservable
reviews
serves_beer
serves_breakfast
serves_brunch
serves_dinner
serves_lunch,
serves_vegetarian_food
serves_wine
takeout
user_ratings_total를 참고하세요.
  필드 마스크 결제 예시

다음은 필드 마스크에서 선택한 필드를 기반으로 요금이 청구되는 방식의 예입니다.

  • 요청 필드 마스크에 이 SKU의 필드만 포함된 경우: 요청에 이 SKU 요금이 청구됩니다. 예를 들어 이 SKU에서 하나 이상의 필드를 요청할 수 있으며 이 SKU 요율로 요금이 청구됩니다.
  • 요청 필드 마스크에 다른 SKU의 필드가 포함된 경우: 요청된 필드에 대해 가장 높은 SKU 요금이 청구됩니다. 예를 들어 Essentials SKU 및 Enterprise SKU와 같은 여러 SKU의 필드를 포함하면 요청에 대해 Enterprise SKU 요금이 청구됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Autocomplete – Per Request

이 SKU는 세션 토큰이 포함되지 않은 요청에 대해 청구됩니다.

잘못된 자동 완성 세션 (예: 세션 토큰을 재사용하는 세션)에서 요청을 하면 Autocomplete – Per Request SKU 요금도 청구됩니다.

잘못된 자동 완성 세션에서 요청을 실행하면 Maps JavaScript API Place Autocomplete 위젯의 Autocomplete 요청에 Autocomplete – Per Request SKU 요금이 청구될 수 있습니다. 이 문제는 사용자가 여러 주소를 입력하거나 위젯에 여러 주소를 복사/붙여넣기하고 항상 자동 완성 예측 검색어를 선택하지 않을 때 발생할 수 있습니다.

  카테고리 Essentials
  청구 가능 이벤트 요청
  트리거 다음에 대해 결제가 트리거됩니다.
  가격 책정 기본 가격표
인도 가격표

SKU: Autocomplete without Place Details – Per Session

이 SKU는 세션 시작 후 몇 분 이내에 Place Details 요청이 포함되지 않은 자동 완성 세션에 대해 요금이 청구됩니다.

  카테고리 Pro
  청구 가능 이벤트 세션
  트리거 애플리케이션이 단일 세션에서 다음 두 요청을 실행하면 청구가 트리거됩니다.

SKU별로 청구서를 확인하면 다음 SKU가 표시됩니다.

  • Autocomplete without Places Details – Per Session
  가격 책정 기본 가격표
인도 가격표

SKU: Autocomplete (included with Place Details) – Per Session

자동 완성 요청은 무료로 사용할 수 있습니다. 이 SKU는 일반 Place Details 가격에 따라 후속 Place Details를 요청할 때 청구됩니다.

  카테고리 Essentials
  청구 가능 이벤트 세션
  트리거 Autocomplete (included with Place Details) – Per Session SKU는 다음 요청 중 하나가 포함된 자동 완성 세션에 대해 요금이 청구됩니다.
  • Android: fetchPlace() 호출
  • iOS: fetchPlaceFromPlaceID: 호출
  • 웹 서비스: Place Details 요청

Place Details 요청을 실행하면 요청에 지정된 필드에 따라 데이터 SKU (Basic, Contact 또는 Atmosphere)가 생성됩니다.

Place Details 요청에서 특정 필드를 요청하지 않으면 모든 데이터 SKU (Essentials, Pro, Enterprise, Enterprise + Atmosphere)가 트리거됩니다. 불필요한 요금 청구를 방지하려면 필요한 필드만 지정하세요.

자동 완성 세션 중에 Place Details ID 새로고침만 요청하는 경우 (요청에서 place_id 필드만 지정) 세션에 SKU: Autocomplete without Place Details – Per Session으로 요금이 청구됩니다.
  예시

애플리케이션이 단일 세션에서 다음 세 호출을 실행하는 경우:

웹 서비스

청구서에 다음 SKU가 표시됩니다(SKU별로 청구서를 표시하는 경우).

  • Autocomplete (included with Place Details) – Per Session
  • 장소 세부정보
  • 기본 데이터
  가격 책정 기본 가격표
인도 가격표

SKU: Query Autocomplete – Per Request

이 기존 SKU는 쿼리 자동 완성 요청에 대해 요금을 청구합니다.

  카테고리 Essentials
  청구 가능 이벤트 요청
  트리거

이 SKU는 다음 서비스를 사용하여 자동 완성 검색어 요청을 할 때 트리거됩니다.

Query Autocomplete를 사용하는 경우 자동 완성 세션별 가격을 지정할 수 없습니다. 후속 Place Details 요청에는 Place Details Pro SKU에 따라 요금이 청구됩니다.

  가격 책정 기본 가격표
인도 가격표

SKU: Place Details Pro

이 SKU는 기존 장소 세부정보 요청에 대해 요금을 청구합니다.

  카테고리 Pro
  청구 가능 이벤트 요청
  트리거 다음 API의 요청에 대해 결제가 트리거됩니다.

웹 API 및 서비스를 사용하면 세션 토큰 제공 여부와 관계없이 Place Details SKU에 요금이 청구됩니다.

이 SKU는 데이터 SKU에 대한 결제도 트리거합니다. 요청에 데이터 필드를 포함하면 데이터 SKU(Basic, Contact, Atmosphere)에 대한 추가 결제가 트리거될 수 있습니다. 불필요한 비용을 피하려면 필요한 데이터 필드만 지정하세요. 이 SKU와 요청한 데이터에 대해 요금이 청구됩니다.
  예시
  1. 다음 중 하나를 호출 또는 요청합니다.
    • 모바일: Android에서는 fetchPlace()를, iOS에서는 fetchPlaceFromPlaceID:를 호출하고 ADDRESS 필드만 지정합니다.
    • 웹 API 또는 서비스: Place Details를 요청하고 주소 필드만 지정합니다. getPlaceDetails(fields: formatted_address)
    청구서에 다음 SKU가 표시됩니다 (SKU별로 청구서를 표시하는 경우).
    • 장소 세부정보
    • 기본 데이터
  2. 다음 중 하나를 호출 또는 요청합니다.
    • 모바일: Android에서는 fetchPlace()를, iOS에서는 fetchPlaceFromPlaceID:를 호출하고 PHONE_NUMBER 필드만 지정합니다.
    • 웹 API 또는 서비스: Place Details를 요청하고 전화번호 필드를 지정합니다. getPlaceDetails(fields: formatted_phone_number)
    청구서에 다음 SKU가 표시됩니다 (SKU별로 청구서를 표시하는 경우).
    • 장소 세부정보
    • Contact Data
  3. 다음 중 하나를 호출 또는 요청합니다.
    • 모바일: Android에서는 fetchPlace()를, iOS에서는 fetchPlaceFromPlaceID:를 호출하고 모든 필드를 지정합니다.
    • 웹 API 또는 서비스: Place Details를 요청하고 모든 필드를 지정합니다 (필드를 지정하지 않는 경우 이 유형의 요청이 기본값). getPlaceDetails()
    청구서에 다음 SKU가 표시됩니다 (SKU별로 청구서를 표시하는 경우).
    • 장소 세부정보
    • 기본 데이터
    • Contact Data
    • Atmosphere Data
  가격 책정 기본 가격표
인도 가격표

SKU: Place Details – ID Refresh

이 SKU는 오래된 장소 ID를 새로고침하는 Place Details API 요청에 대해 요금이 청구됩니다.

  카테고리 Essentials
  청구 가능 이벤트 요청
  트리거 Place Details를 요청하고 장소 ID 필드만 지정하면 청구가 트리거됩니다. getPlaceDetails(fields: place_id).
  가격 책정 기본 가격표
인도 가격표

SKU: Find Place

이 SKU는 장소 ID 외의 더 많은 필드를 반환하는 Find Place 요청에 대해 요금이 청구됩니다.

이 SKU는 데이터 SKU에 대한 결제도 트리거합니다. 요청에 데이터 필드를 포함하면 데이터 SKU(Basic, Contact, Atmosphere)에 대한 추가 결제가 트리거될 수 있습니다. 불필요한 비용을 피하려면 필요한 데이터 필드만 지정하세요. 이 SKU와 요청한 데이터에 대해 요금이 청구됩니다.

  카테고리 Pro
  청구 가능 이벤트 요청
  트리거 이 SKU는 다음 메서드에 대한 요청에 대해 청구됩니다.
  • Find Current Place

이 SKU는 데이터 SKU에 대한 결제도 트리거합니다. 요청에 데이터 필드를 포함하면 데이터 SKU(Basic, Contact, Atmosphere)에 대한 추가 결제가 트리거될 수 있습니다. 불필요한 비용을 피하려면 필요한 데이터 필드만 지정하세요. 이 SKU와 요청한 데이터에 대해 요금이 청구됩니다.
  예시

다음 예에서는 현재 위치 찾기 요청을 실행하고 Basic, Contact, Atmosphere 데이터 SKU의 필드를 지정할 때 청구되는 SKU를 보여줍니다. 청구서에서 SKU를 보려면 SKU당 사용량 및 비용 분석에 설명된 대로 SKU별로 청구서를 확인하세요.

  1. Find Place를 요청하고 주소 필드만 지정합니다. FindPlace(fields: formatted_address). 청구서에 다음 SKU가 표시됩니다.
    • Find Place
    • 기본 데이터
  2. Find Place를 요청하고 전화번호 필드를 지정합니다. FindPlace(fields: formatted_phone_number). 청구서에 다음 SKU가 표시됩니다.
    • Find Place
    • Contact Data
  3. Find Place를 요청하고 세 가지 데이터 유형 버킷 모두에서 필드를 지정합니다. FindPlace(fields: formatted_address, opening_hours, price_level). 청구서에 다음 SKU가 표시됩니다.
    • Find Place
    • 기본 데이터
    • Contact Data
    • Atmosphere Data
  가격 책정 기본 가격표
인도 가격표

SKU: Find Place – ID only

이 SKU는 장소 ID만 반환하는 Find Place 요청에 대해 요금이 청구됩니다. 기본적으로 Find Place 요청에 필드를 지정하지 않으면 장소 ID만 반환됩니다.

  카테고리 Essentials
  청구 가능 이벤트 요청
  트리거 지정된 필드 없이 Find Place를 요청하거나 place_id 필드만 지정합니다. FindPlace(fields: place_id).
  가격 책정 기본 가격표
인도 가격표

SKU: Places – Nearby Search

이 SKU는 Nearby Search 요청에 대해 청구됩니다.

  카테고리 Pro
  청구 가능 이벤트 요청
  트리거 이 SKU는 다음 API 중 하나를 사용하여 Nearby Search 요청을 실행할 때 트리거됩니다.

이 요청은 반환할 필드를 지정하는 것을 지원하지 않습니다. 응답은 장소 목록과 지원되는 데이터 필드의 하위 집합을 반환합니다.

이 SKU는 데이터 SKU에 대한 결제도 트리거합니다. 요청에 데이터 필드를 포함하면 데이터 SKU(Basic, Contact, Atmosphere)에 대한 추가 결제가 트리거될 수 있습니다. 불필요한 비용을 피하려면 필요한 데이터 필드만 지정하세요. 이 SKU와 요청한 데이터에 대해 요금이 청구됩니다.
  예시

Nearby Search를 요청합니다. 예: NearbySearch (San Francisco, 100 meters). SKU별로 청구서를 확인하면 청구서에 다음 SKU가 표시됩니다.

  • 장소
  • 기본 데이터
  • Contact Data
  • Atmosphere Data
  가격 책정 기본 가격표
인도 가격표

SKU: Places – Text Search

이 SKU는 Places Text Search 서비스 요청에 대해 요금이 청구됩니다.

  카테고리 Pro
  청구 가능 이벤트 요청
  트리거 다음 서비스에 대한 요청에 대해 결제가 트리거됩니다.

Text Search 요청은 장소 목록을 반환하지만 반환되는 필드는 지정할 수 없습니다. Text Search 요청은 지원되는 데이터 필드의 하위 집합을 반환합니다. Text Search 요청 및 모든 데이터 유형 SKU(Basic Data, Contact Data, Atmosphere Data)에 대해 요금이 청구됩니다.

Place – Text Search SKU는 여기 표시된 대로 사용자가 결과 (아이콘: 핀)가 아니라 장소 검색어 (아이콘: 돋보기)를 선택한 후 Maps JavaScript API Place SearchBox 위젯: getPlaces() 메서드에 의해서도 트리거됩니다.

장소 세부정보 검색창 위젯 검색어 선택
검색창에 'pizza'를 입력하면 표시되는 검색창 위젯의 결과에서 pizza delivery 옆에 (결과가 아니라) 장소 검색어임을 나타내는 돋보기 아이콘이 표시됩니다.
  예

TextSearch(123 Main Street)와 같은 Text Search를 요청하면 SKU별로 청구서를 확인할 때 청구서에 다음 SKU가 표시됩니다.

  • 장소 - 텍스트 검색
  • 기본 데이터
  • Contact Data
  • Atmosphere Data
  가격 책정 기본 가격표
인도 가격표

SKU: Places API Place Details Photos

이 SKU는 기존 Places Photo 서비스에 대해 요금이 청구됩니다.

  카테고리 Enterprise
  청구 가능 이벤트 요청
  트리거 다음에 대해 결제가 트리거됩니다.
  가격 책정 기본 가격표
인도 가격표

기타 사용량 한도

일일 최대 요청 수는 없지만 다음과 같은 사용량 한도는 계속 적용됩니다.

  • Places API (신규): 비율 제한은 프로젝트당 API 메서드당 600QPM(분당 요청 수)입니다. 즉, 각 API 메서드에는 별도의 할당량이 있습니다.

  • Places API: 비율 제한은 QPM (분당 요청 수) 6,000개입니다. 동일한 프로젝트의 사용자 인증 정보를 사용하는 모든 애플리케이션의 클라이언트 측 요청과 서버 측 요청의 합계로 계산됩니다.

이용약관 제한

이용약관에 대한 자세한 내용은 Places API 정책 및 Google Maps Platform 서비스 약관의 라이선스 제한 섹션을 참고하세요.