마이그레이션 개요

iOS용 Places SDK (신규)는 성능이 개선되고 새로운 가격 모델을 제공하므로 iOS용 Places SDK (기존)를 사용하는 앱을 업데이트하는 것이 좋습니다. 기능 비교에 관한 자세한 내용은 SDK 선택을 참고하세요.

이 가이드를 통해 iOS용 Places SDK(신규)와 iOS용 Places SDK (기존)의 주요 차이점을 파악하고 필요한 변경사항을 처리하는 방법을 알아보세요.

마이그레이션 결제 권장사항

이 안내는 API 사용량이 2단계 요금으로 전환될 만큼 많은 경우에 적용됩니다. API의 최신 버전으로 이전하면 다른 SKU에 대한 요금도 청구됩니다. 전환하는 달에 비용이 증가하지 않도록 하려면 가능한 한 달 초에 프로덕션에서 새 API로 전환하는 것이 좋습니다. 이렇게 하면 이전 달에 가장 비용 효율적인 월간 요금 등급에 도달할 수 있습니다. 가격 등급에 대한 자세한 내용은 가격 페이지가격 FAQ를 참고하세요.

오류: kGMSPlacesRateLimitExceeded

iOS용 Places SDK (신규) 사용 설정

iOS용 Places SDK는 Places API 서비스를 사용합니다. iOS용 Places SDK (신규)의 기능을 사용하려면 먼저 Google Cloud 프로젝트에서 Places API (신규)를 사용 설정해야 합니다. 자세한 내용은 Google Cloud 프로젝트 설정을 참고하세요.

그런 다음 앱에서 사용하는 API 키에 Places API(New)를 추가했는지 확인해야 합니다. 자세한 내용은 API 키 사용을 참고하세요.

일반적인 변경사항

여러 API에 적용되는 일반적인 변경사항은 다음과 같습니다.

  • 새로운 가격 책정 모델을 사용합니다. 모든 API의 가격 정보는 iOS용 Places SDK(신규) 가격을 참고하세요.

  • 장소 세부정보(신규), 주변 검색(신규), 텍스트 검색(신규)에서는 응답에 반환할 필드를 지정하기 위해 필드 마스크가 필요합니다.

  • GMSPlacesClient에는 이러한 새 API를 호출하는 새 메서드가 포함되어 있습니다.

  • 각 새 API에 대한 요청을 정의하는 새 클래스가 추가되었습니다.

  • 응답 GMSPlace 인스턴스에는 GMSPlaceReview 유형의 새 reviews 속성이 포함됩니다. 앱에서 사진, 리뷰 등 GMSPlace 인스턴스에서 가져온 정보를 표시하는 경우 필수 저작자 표시도 함께 표시해야 합니다.

    자세한 내용은 저작자 표시 문서를 참고하세요.

API별 변경사항

이 섹션에는 각 API에 대한 다음 이전 가이드가 포함되어 있습니다.