이 페이지에서는 기존 Places API, 기존 Directions API, 기존 Distance Matrix API SKU의 SKU 세부정보, SKU ID, 청구 가능한 이벤트, 청구 트리거를 제공합니다. 이러한 서비스의 현재 버전은 장소 (신규) SKU 세부정보 및 경로 및 탐색 SKU 세부정보를 참고하세요. 모든 제품 카테고리 디렉터리는 API 사용량 세부정보 개요를 참조하세요.
SKU 표 정보
다음 섹션에서는 각 SKU의 세부정보를 간략하게 설명합니다.
| 카테고리 | SKU가 Essentials, Pro 또는 Enterprise SKU 카테고리에 속하는지 여부입니다. |
| 청구 대상 이벤트 | SKU에 청구되는 이벤트입니다. |
| 트리거 | 청구 가능 이벤트를 트리거하는 코드 요소 |
| 가격 책정 | SKU 그룹의 가격표 링크입니다. |
기존 Places 제품 SKU
최신 버전은 Places (New) 제품 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 데이터 필드가 포함된 장소 세부정보 요청에 대해서는 Basic Data SKU 및 장소 세부정보 SKU 모두에 따라 요금이 청구됩니다.
웹 서비스의 경우 다음 Places API 요청을 사용하여 반환할 데이터 필드를 지정할 수 있습니다.
웹 서비스의 경우 다음 Places API 호출에서는 반환된 필드를 지정할 수 없습니다. 이 호출에서는 항상 모든 장소 데이터를 반환하고 각 API 요청에 대한 요금 외에 세 개의 Places Data SKU에 대해 요금을 청구합니다.
[ Essentials: Places Legacy ] |
|---|
SKU: Autocomplete – Per Request
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
7384-2DE4-D388 (전 세계) 2164-BC00-53DC (인도) |
|
| API | Place Autocomplete (기존) Android, Place Autocomplete (기존) iOS, Place Autocomplete (기존) 웹 |
|
| 청구 대상 이벤트 | 세션 토큰이 포함되지 않은 요청 | |
| 트리거 |
|
|
| 예시 | 잘못된 자동 완성 세션 (예: 세션 토큰을 재사용하는 세션)에서 요청하는 경우에도 Autocomplete – Per Request SKU 요금이 청구됩니다. 잘못된 Autocomplete 세션에서 요청하는 경우 Maps JavaScript API Place Autocomplete 위젯의 Autocomplete 요청에 Autocomplete – Per Request SKU 요금이 청구될 수 있습니다. 이 문제는 사용자가 위젯에 여러 주소를 입력하거나 복사/붙여넣기하고 항상 자동 완성 예상 검색어를 선택하지 않을 때 발생할 수 있습니다. |
|
| 가격 책정 |
가격 목록 (전 세계) 가격 목록 (인도) |
SKU: Autocomplete (included with Place Details) – Per Session
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
E9C9-934B-DDB1 (전 세계) |
|
| API | Place Autocomplete (기존) Android, Place Autocomplete (기존) iOS, Place Autocomplete (기존) 웹 |
|
| 청구 대상 이벤트 | 세션 | |
| 트리거 |
요청의 필드: 불필요한 비용이 청구되지 않도록 요청에 필요한 필드를 지정해야 합니다. 지정하는 필드에 따라 장소 세부정보 요청은 다음 데이터 SKU도 생성합니다. Place Details 요청에서 필드를 지정하지 않으면 모든 데이터 SKU가 트리거됩니다. 자동 완성 세션 중에 장소 세부정보 ID 새로고침만 요청하는 경우 (요청에서 |
|
| 예시 |
자동 완성 요청은 무료로 사용할 수 있습니다. 이 기존 SKU는 일반 장소 세부정보 가격 책정에 따라 후속 장소 세부정보를 요청할 때 청구됩니다. 이 예시에서는 SKU별로 청구서를 표시할 때 청구서에 다음 SKU가 표시되는 플랫폼별 요청 시리즈를 보여줍니다.
플랫폼별 요청 예시: Android 요청
iOS 요청
웹 서비스 요청
Place Autocomplete 요청 (입력='par', session_token: XYZ) |
|
| 가격 책정 |
가격 목록 (전 세계) 가격 목록 (인도) |
자동 완성 세션에 대한 정보
자동 완성 세션에는 사용자가 장소를 입력함과 동시에 추천 검색어를 가져오기 위한 Autocomplete 요청 및 사용자가 선택한 장소에 대한 세부정보를 가져오기 위한 최대 1개의 Place Details 요청이 포함됩니다. 동일한 세션 토큰이 Autocomplete 및 이후의 Place Detail 요청에 전달됩니다. 세션은 첫 번째 Autocomplete 요청으로 시작됩니다. 이 요청은 일반적으로 사용자가 입력을 시작할 때 발생합니다. 사용자가 Autocomplete 추천 검색어 중 하나를 선택하면 Place Details 호출이 이루어집니다. 사용자가 추천 검색어를 선택하지 않으면 Place Details 호출이 이루어지지 않습니다.
사용자가 장소를 선택한 후 (즉, 장소 세부정보 호출이 이루어진 후) 새 세션 토큰을 사용하여 새 세션을 시작해야 합니다.
자동 완성 세션은 다음과 같은 API에서 생성할 수 있습니다.
- Places API Place Autocomplete 서비스 또는 Maps JavaScript API Place Autocomplete 서비스. 세션 토큰을 제공하도록 애플리케이션을 설계해야 합니다. 기존 코드를 변경해야 할 수도 있습니다.
- Maps JavaScript API Autocomplete 위젯 이 위젯에서는 코드를 변경하지 않아도 세션 기반 결제가 자동으로 사용 설정됩니다.
세션 토큰은 하나의 사용자 세션에 유효하며 두 개 이상의 사용자 세션에 사용해서는 안 됩니다. 세션 토큰을 재사용하면 세션이 유효하지 않은 것으로 간주되어 세션 토큰이 제공되지 않은 것처럼 요청에 대해 요금이 청구됩니다.
세션을 사용하는 Autocomplete 요청 및 Place Details 요청에 대해서는 서로 다른 SKU에 따라 요금이 청구됩니다.
SKU: Basic Data
장소 세부정보 또는 장소 검색 요청의 Basic Data 데이터 필드에 대해 요금을 청구하는 데이터 SKU입니다.
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
75D4-C522-326B (전 세계) 5D7B-1F7B-395E (인도) |
|
| API |
장소 세부정보 (기존)
기본 필드 사용
장소 찾기 (기존) 기본 필드 사용 |
|
| 청구 대상 이벤트 | 기본 데이터 필드 요청 성공 | |
| 트리거 |
Android SDK 필드
iOS용 필드
웹 서비스 필드
|
|
| 필드 마스크 결제 |
요청은 필드 마스크에 제공된 필드를 기준으로 청구됩니다. 예를 들면 다음과 같습니다.
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Find Place – ID only
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
44A2-D839-A3AC (전역) FE05-60A4-CDDF (인도) |
|
| API | 장소 웹 서비스 장소 찾기 | |
| 청구 대상 이벤트 | place_id만 요청 성공 |
|
| 트리거 | 필드가 지정되지 않았거나 place_id 필드만 지정된 장소 검색 요청: FindPlace(fields: place_id) |
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Place Details – ID Refresh
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
2D88-4302-6299 (전 세계) 4604-F56B-7086 (인도) |
|
| API | 장소 세부정보 (기존) | |
| 청구 대상 이벤트 | ID 필드만 요청 성공 | |
| 트리거 | 장소 ID 필드만 있는 요청:
getPlaceDetails(fields: place_id). |
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Query Autocomplete – Per Request
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
C4B1-8805-63EF (전 세계) 59E9-EB83-5CA3 (인도) |
|
| API | Query Autocomplete 서비스 | |
| 청구 대상 이벤트 | 요청 성공 | |
| 트리거 |
Query Autocomplete를 사용하는 경우 자동 완성 세션별 가격을 지정할 수 없습니다. 이후의 장소 세부정보 요청에는 Place Details Pro SKU에 따라 요금이 청구됩니다. |
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
[ Pro: Places Legacy ] |
|---|
SKU: Autocomplete without Place Details – Per Session
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
B52C-8320-6DC5 (전 세계) C625-D3CE-DF37 (인도) |
|
| API | Place Autocomplete (기존) Android, Place Autocomplete (기존) iOS, Place Autocomplete (기존) 웹 |
|
| 청구 대상 이벤트 | 세션 | |
| 트리거 |
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Find Current Place
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
7218-264C-D1D7 (전 세계) 0862-F46E-1A1A (인도) |
|
| API | Android용 Places SDK, iOS용 Places SDK |
|
| 청구 대상 이벤트 | 요청 성공 | |
| 트리거 |
|
|
| 예시 |
다음 예는 현재 장소 찾기 요청을 실행하고 Basic, Contact, Atmosphere 데이터 SKU의 필드를 지정할 때 청구되는 SKU를 보여줍니다. 청구서에서 SKU를 보려면 SKU당 사용량 및 비용 분석에 설명된 대로 SKU별로 청구서를 확인하세요.
청구서에 다음 SKU가 표시됩니다.
청구서에 다음 SKU가 표시됩니다.
세 가지 데이터 유형 필드를 모두 사용하여 현재 장소 찾기를 요청합니다.
청구서에 다음 SKU가 표시됩니다.
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Find Place
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
DC67-3188-2294 (전 세계) ECB4-087C-9A27 (인도) |
|
| API | 장소 찾기 (기존) | |
| 청구 대상 이벤트 | ID 필드 이외의 요청 성공 | |
| 트리거 | ID 필드 외에 다른 필드도 지정된 Find Place 요청 | |
| 예시 |
다음 예는 현재 장소 찾기 요청을 실행하고 Basic, Contact, Atmosphere 데이터 SKU의 필드를 지정할 때 청구되는 SKU를 보여줍니다. 청구서에서 SKU를 보려면 SKU당 사용량 및 비용 분석에 설명된 대로 SKU별로 청구서를 확인하세요.
청구서에 다음 SKU가 표시됩니다.
청구서에 다음 SKU가 표시됩니다.
세 가지 데이터 유형 필드를 모두 사용하여 Find Place를 요청합니다.
청구서에 다음 SKU가 표시됩니다.
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Places – Nearby Search
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
6B23-8A17-D29D (전 세계) CC66-BE0E-2477 (인도) |
|
| API | 주변 검색 (기존) | |
| 청구 대상 이벤트 | Pro 기능 요청 완료 | |
| 트리거 |
이 요청은 반환할 필드를 지정하는 것을 지원하지 않습니다. 응답은 장소 목록과 지원되는 데이터 필드의 하위 집합을 반환합니다. |
|
| 예시 |
주변 지역 검색을 요청합니다. 예를 들면
|
|
| 가격 책정 |
가격 목록 (전 세계) 가격 목록 (인도) |
SKU: Places – Text Search
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
E95A-86C7-7F47 (전 세계) 102E-888D-5596 (인도) |
|
| API | 텍스트 검색 (기존) | |
| 청구 대상 이벤트 | 텍스트 검색 (기존)에 대한 성공적인 요청 | |
| 트리거 |
텍스트 검색 요청은 장소 목록을 반환하지만 반환되는 필드는 지정할 수 없습니다. 텍스트 검색 요청은 지원되는 데이터 필드의 하위 집합을 반환합니다. 텍스트 검색 요청 및 모든 데이터 유형 SKU(Basic Data, Contact Data, Atmosphere Data)에 대해 요금이 청구됩니다.
SKU: Places – 텍스트 검색은 여기 표시된 대로 사용자가 결과(아이콘: 핀)가 아니라 장소 검색어(아이콘: 돋보기)를 선택한 후
Maps JavaScript API Place SearchBox 위젯:
|
|
| 예시 |
텍스트 검색 (기존)을 요청하면 SKU별로 청구서를 표시할 때 청구서에 다음 SKU가 표시됩니다.
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Places Details
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
FC5C-DF28-543F (전 세계) F7AA-FEF9-C90E (인도) |
|
| API | 장소 세부정보 (기존) | |
| 청구 대상 이벤트 | Pro 기능 요청 완료 | |
| 트리거 |
웹 API 및 서비스를 사용하면 세션 토큰 제공 여부와 관계없이 장소 세부정보 SKU에 요금이 청구됩니다. |
|
| 예시 |
|
|
| 가격 책정 |
가격 목록 (전 세계) 가격 목록 (인도) |
[ Enterprise: Places Legacy ] |
|---|
SKU: Atmosphere Data
Place Details 또는 Find Place 요청의 Atmosphere Data 필드에 대해 청구하는 데이터 SKU입니다.
| 카테고리 | Enterprise | |
|---|---|---|
| SKU ID |
D63D-5CC5-302A (전 세계) 0CE0-1963-137E (인도) |
|
| API |
Atmosphere 필드가 있는
장소 세부정보 (기존)
Atmosphere 필드가 있는 장소 찾기 (기존) |
|
| 청구 대상 이벤트 | Atmosphere 데이터 필드 요청 성공 | |
| 트리거 | ||
| 필드 마스크 결제 예시 |
요청은 필드 마스크에 제공된 필드를 기준으로 청구됩니다. 예를 들면 다음과 같습니다.
|
|
| 가격 책정 | 가격 목록 (전 세계) 가격 목록 (인도) |
SKU: Contact Data
장소 세부정보 또는 장소 찾기 요청의 연락처 데이터 필드에 대해 청구하는 데이터 SKU입니다.
| 카테고리 | Enterprise | |
|---|---|---|
| SKU ID |
F095-CD01-81B2 (전 세계) A03F-5079-C66C (인도) |
|
| API |
연락처 필드가 있는
장소 세부정보 (기존)
연락처 필드가 있는 장소 찾기 (기존) |
|
| 청구 대상 이벤트 | 연락처 데이터 필드 요청 성공 | |
| 트리거 |
Android SDK 필드
iOS SDK 필드
웹 서비스 필드
|
|
| 필드 마스크 결제 |
요청은 필드 마스크에 제공된 필드를 기준으로 청구됩니다. 예를 들면 다음과 같습니다.
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Places Photo
| 카테고리 | Enterprise | |
|---|---|---|
| SKU ID |
81E7-85D0-58A7 (전 세계) 9F4B-2E19-1B63 (인도) |
|
| API | Places Photo (기존) | |
| 청구 대상 이벤트 | 사진 요청 성공 | |
| 트리거 |
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
기존 Routes API SKU
[ Essentials: Routes Legacy ] |
|---|
SKU: Directions
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
28A8-3EB4-4595 (전 세계) 4714-291C-3199 (인도) |
|
| API | Maps JavaScript API의 Directions Service, Directions API (기존) |
|
| 청구 대상 이벤트 | Pro 또는 Enterprise 기능이 없는 성공적인 요청 | |
| 트리거 | 더 높은 등급의 SKU를 트리거하지 않는 쿼리 | |
| 가격 책정 |
가격 목록 (전 세계) 가격 목록 (인도) |
SKU: Distance Matrix
| 카테고리 | Essentials | |
|---|---|---|
| SKU ID |
C1B6-FF9D-7700 (전 세계) 558A-4F88-F361 (인도) |
|
| API | Distance Matrix API (기존), Maps JavaScript API Distance Matrix Service |
|
| 청구 대상 이벤트 | Pro 또는 Enterprise 기능이 포함되지 않은 각 요소 Distance Matrix API에 전송된 각 요청은 요소를 생성합니다. 여기서 origins 수 x destinations 수가 요소 수입니다. |
|
| 트리거 | 더 높은 가격의 SKU를 트리거하지 않는 요소에 대한 요청 | |
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
[ Pro: Routes Legacy ] |
|---|
SKU: Directions Advanced
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
9407-00C2-CF85 (전 세계) E27B-BD57-FD7D (인도) |
|
| API | Maps JavaScript API의 Directions Service, Directions API (기존) |
|
| 청구 대상 이벤트 | Pro 기능을 사용한 요청 성공 | |
| 트리거 |
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
SKU: Distance Matrix Advanced
| 카테고리 | Pro | |
|---|---|---|
| SKU ID |
DFAE-763F-CF6E (전 세계) C0F4-32AE-F6D1 (인도) |
|
| API | Distance Matrix API (기존), Maps JavaScript API Distance Matrix Service |
|
| 청구 대상 이벤트 | 각 요소는 Pro 기능과 함께 반환됩니다. Distance Matrix API에 전송된 각 요청은 요소를 생성합니다. 여기서 origins 수 x destinations 수가 요소 수입니다. |
|
| 트리거 |
|
|
| 가격 책정 |
가격 목록 (전 세계)
가격 목록 (인도) |
관련 SKU 세부정보 페이지
- API 사용량 세부정보 개요: Essentials, Pro, Enterprise, 기존 등급별로 정리된 전체 SKU 디렉터리입니다.
- 지도 SKU 세부정보: Android용 Maps SDK, iOS용 Maps SDK, Maps JavaScript API, Maps Embed API, Maps Static API, 스트리트 뷰 Static API, Elevation API, Aerial View API, Map Tiles API SKU
- 경로 SKU 세부정보: Routes API, Route Optimization API, Roads API, Navigation SDK SKU
- Places (신규) SKU 세부정보: Places API (신규), 장소 UI 키트, Places Aggregate API, Address Validation API, Geocoding API, Geolocation API, 시간대 API, Maps Grounding Lite SKU
- 환경 SKU 세부정보: Air Quality API, Pollen API, Solar API, Weather API SKU
- Google Maps Platform 가격 책정 및 인도 가격 책정: 월별 사용량 등급 및 이벤트당 요율