소개
Places API를 사용하면 텍스트 문자열 또는 근접성을 사용하여 다양한 장소 유형의 정보를 검색하고 가져올 수 있습니다. Places API (기존)는 Places API (신규)의 기존 버전입니다.
다음 표에는 두 API의 상응하는 버전이 나와 있습니다. 이 가이드를 사용하여 두 API의 주요 차이점을 파악하고 Places API (신규)로 이전하세요.
| Places API (기존) | Places API (신규) | 참고 |
|---|---|---|
| 장소 검색 (기존) | 텍스트 검색 (신규) | 장소 검색 (기존)의 새 버전은 없습니다. 텍스트 검색 (신규)으로 대체되었습니다. |
| 주변 검색 (기존) | 주변 지역 검색 (신규) | 주변 지역 검색 (신규)은 텍스트 입력을 지원하지 않으므로 텍스트 쿼리가 포함된 기존 API를 사용하는 모든 요청은 텍스트 검색 (신규) 을 사용해야 합니다. |
| 텍스트 검색 (기존) | 텍스트 검색 (신규) | |
| 장소 세부정보 (기존) | 장소 세부정보 (신규) | |
| Place Photos (기존) | Place Photos (신규) | |
| Place Autocomplete (기존) | 자동 완성 (신규) | |
| Query Autocomplete (기존) | 자동 완성 (신규) | 자동 완성 (신규)에 기능이 추가되었습니다. |
새 API로 이전
새 API로 이전하려면 다음 이전 가이드를 참고하세요.
Places API (신규)에 추가된 주요 기능
이 섹션에서는 Places API (신규)에 추가된 주요 기능을 다룹니다.
Google Cloud 표준 플랫폼에서 구현
Places API (신규)는 서비스 인프라 에서 Google Cloud에 구현됩니다. 이 구현은 OAuth와 같은 향상된 보안 옵션을 갖춘 더 안전하고 신뢰할 수 있는 플랫폼을 제공합니다. 이 표준 API 설계는 Places API (신규)를 사용한 개발 효율성을 개선하는 API 전반에 일관성을 제공합니다.
성능 향상
Places API (신규)는 성능이 개선되어 기존 Places API를 사용하는 앱을 대체할 가치가 있습니다.
간소화된 가격 책정
Places API (신규)를 사용하면 가격 책정이 간소화되어 사용한 데이터에 대해서만 비용을 지불하면 됩니다. 간소화된 가격 책정은 필드 마스크를 사용하여 구현됩니다.
장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규)을 사용하면 필드 마스크를 사용하여 응답에서 반환할 필드 목록을 제어할 수 있습니다. 그러면 요청된 데이터에 대해서만 요금이 청구됩니다. 필드 마스크를 사용하면 불필요한 데이터의 요청을 방지하여 불필요한 처리에 드는 시간과 요금을 막을 수 있습니다.
장소에 대한 일관된 응답 데이터
기존 API를 사용하면 장소 세부정보 (기존), 주변 지역 검색 (기존), 텍스트 검색 (기존) API가 장소에 대해 서로 다른 응답 데이터를 반환했습니다. Places API (신규)는 응답을 표준화하므로 이러한 API는 모두 장소에 대해 동일한 데이터를 반환합니다.
확장된 장소 유형
이제 API 응답에 장소의 기본 유형 이 포함될 수 있습니다. 모든 장소에는 표 A에 나열된 대로 장소의 기본 유형으로 지정된 단일 유형 값이 있을 수 있습니다.
새 API에는 여러 가지 새로운 유형도 포함되어 있습니다. 주변 검색 (신규) 및 텍스트 검색 (신규)을 사용하여 검색에서 이러한 새 유형과 기존 유형을 사용할 수 있습니다. 새 유형은 모두 표 A에 포함되어 있습니다.
동적 장소 데이터
Places API (신규)는 전기자동차 충전소의 사용 가능 여부 또는 주유소의 최신 연료 가격과 같은 동적 응답 데이터를 지원합니다. 이러한 응답 필드를 사용하여 동적 사용자 환경을 만드세요.