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