소개
Places API (신규)는 성능이 개선되고 새로운 가격 책정 모델을 제공하므로 Places API (기존)를 사용하는 앱을 업데이트하는 것이 좋습니다. 기능 비교에 대한 자세한 내용은 API 선택을 참고하세요.
이 가이드를 사용하여 Places API (기존)와 비교하여 Places API (신규)의 주요 차이점을 파악하고 필요한 변경사항을 처리하는 방법을 알아보세요.
이전을 위한 결제 권장사항
이 안내는 API 사용량이 2단계 가격 책정으로 이동할 만큼 높은 경우에 적용됩니다. 최신 버전의 API로 이전할 때 다른 SKU에 대한 요금도 청구됩니다. 전환 기간 동안 비용이 증가하지 않도록 하려면 가능한 한 월초에 프로덕션에서 새 API로 전환하는 것이 좋습니다. 이렇게 하면 이전 기간 동안 가장 비용 효율적인 월별 가격 책정 등급에 도달할 수 있습니다. 가격 책정 등급에 대한 자세한 내용은 가격 책정 페이지 및 가격 책정 FAQ를 참고하세요.
Places API (신규) 사용 설정
Places API (신규)의 기능을 사용하려면 먼저 Google Cloud 프로젝트에서 Places API (신규) 를 사용 설정해야 합니다. 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.
그런 다음 앱에서 사용하는 API 키에 Places API (신규)를 추가했는지 확인해야 합니다. 자세한 내용은 API 키 사용을 참고하세요.
일반적인 변경사항
여러 API에 적용되는 일반적인 변경사항은 다음과 같습니다.
- 모든 새 API는 인증 메커니즘으로 API 키 와 OAuth 토큰을 모두 지원합니다.
- JSON만 응답 형식으로 지원됩니다.
- 응답에서 반환할 필드를 지정하려면 장소 세부정보 (신규), 주변 지역 검색 (신규), 텍스트 검색 (신규)에 필드 마스크가 필요합니다. 자세한 내용은 FieldMask를 참고하세요.
- 이제 주변 지역 검색 (신규) 및 텍스트 검색 (신규) API는 Place Details (신규)에서 반환하는 장소 세부정보와 일치하도록 전체 장소 세부정보를 반환합니다.
- Place Details (신규),주변 지역 검색 (신규), 및 텍스트 검색 (신규) API의 JSON 응답 형식이 기존 API의 형식에서 변경되었습니다. 자세한 내용은 Places API 응답 이전을 참고하세요.
API별 변경사항
이 섹션에는 각 API의 다음 이전 가이드가 포함되어 있습니다.