iOS용 Places SDK (신규)는 성능이 개선되었으며 새로운 가격 모델을 제공하므로 iOS용 Places SDK (기존)를 사용하는 앱을 업데이트하는 것이 좋습니다. 기능 비교에 관한 자세한 내용은 SDK 선택을 참고하세요.
이 가이드를 통해 iOS용 Places SDK(신규)와 iOS용 Places SDK (기존)의 주요 차이점을 파악하고 필요한 변경사항을 처리하는 방법을 알아보세요.
마이그레이션 결제 권장사항
이 안내는 API 사용량이 2단계 요금으로 전환될 만큼 높은 경우에 적용됩니다. 최신 버전의 API로 이전하면 다른 SKU에 대한 요금도 청구됩니다. 전환하는 달에 비용이 증가하지 않도록 하려면 가능한 한 달 초에 프로덕션에서 새 API로 전환하는 것이 좋습니다. 이렇게 하면 이전 달에 가장 비용 효율적인 월별 요금 등급에 도달할 수 있습니다. 가격 등급에 대한 자세한 내용은 가격 페이지 및 가격 FAQ를 참고하세요.
오류: kGMSPlacesRateLimitExceeded
Places API(신규)
iOS용 Places SDK는 Places API 서비스를 사용합니다. iOS용 Places SDK (신규)의 기능을 사용하려면 먼저 Google Cloud 프로젝트에서 Places API (신규)를 사용 설정해야 합니다. 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.
그런 다음 앱에서 사용하는 키의 승인된 API 목록에 Places API(New)를 추가했는지 확인해야 합니다. 자세한 내용은 API 키 사용을 참고하세요.
Places API (신규)의 할당량이 충분한지 확인
iOS용 Places SDK (신규)에 iOS용 Places SDK의 현재 트래픽을 처리할 수 있는 충분한 할당량이 있는지 확인합니다. 할당량 및 사용량 한도를 검토하고 관리하려면 할당량 및 할당량 알림을 참고하세요. 두 API의 차이점은 다음과 같습니다.
- iOS용 Places SDK (기존)의 할당량은 Places API 서비스의 할당량에 따라 달라집니다. 모든 Places API 메서드의 합계입니다.
- iOS용 Places SDK (신규)의 할당량은 Places API (신규) 서비스의 할당량을 사용합니다. API 메서드마다 별도의 할당량이 있습니다.
협상된 계약에 Places API (신규)가 포함되어 있는지 확인
협상된 계약이 있는 경우 예상 가격으로 Places API (New)가 포함되어 있는지 확인합니다. 그렇지 않은 경우 Google의 영업 담당자 또는 파트너에게 문의하여 이 API를 포함하는 방법을 논의하세요.
일반적인 변경사항
여러 API에 적용되는 일반적인 변경사항은 다음과 같습니다.
새로운 가격 책정 모델을 사용합니다. 모든 API의 가격 정보는 iOS용 Places SDK(신규) 가격을 참고하세요.
장소 세부정보(신규), 주변 검색(신규), 텍스트 검색(신규)에는 응답에서 반환할 필드를 지정하는 필드 마스크가 필요합니다.
GMSPlacesClient에는 이러한 새 API를 호출하는 새 메서드가 포함되어 있습니다.각 새 API에 대한 요청을 정의하는 새 클래스가 추가되었습니다.
응답
GMSPlace인스턴스에는GMSPlaceReview유형의 새reviews속성이 포함됩니다. 앱에서 사진, 리뷰 등GMSPlace인스턴스에서 가져온 정보를 표시하는 경우 필수 저작자 표시도 함께 표시해야 합니다.자세한 내용은 저작자 표시 문서를 참고하세요.
API별 변경사항
이 섹션에는 각 API에 대한 다음 이전 가이드가 포함되어 있습니다.