Places SDK for iOS（新版）では、パフォーマンスが向上し、新しい料金モデルが導入されたため、Places SDK for iOS（旧版）を使用しているアプリを更新する価値があります。機能の比較について詳しくは、 SDK を選択するをご覧ください。
このガイドでは、Places SDK for iOS（新版）と Places SDK for iOS（旧版）の主な違いと、必要な変更を行う方法について説明します。
移行に関する請求のベスト プラクティス
このガイダンスは、API の使用量が 2 段階目の料金に移行するほど多い場合に適用されます。新しいバージョンの API に移行すると、別の SKU の料金も請求されます。移行月の費用が増加しないようにするには、できるだけ月の初めに本番環境で新しい API に切り替えることをおすすめします。これにより、移行月に最も費用対効果の高い月額料金階層に到達できます。料金階層については、 料金ページ と料金に関するよくある質問をご覧ください。
エラー: kGMSPlacesRateLimitExceeded
Places API（新規）
Places SDK for iOS は Places API サービスに依存しています。Places SDK for iOS（新版）の機能を使用するには、まず Google Cloud プロジェクトでPlaces API（新版） を有効にする必要があります。詳しくは、Google Cloud プロジェクトをセットアップするをご覧ください。
次に、アプリで使用するキーの承認済み API のリストに Places API (New) が追加されていることを確認します。詳しくは、Use API Keysをご覧ください。
Places API（新版）に十分な割り当てがあることを確認する
Places SDK for iOS（新版）に、Places SDK for iOS の現在のトラフィックをカバーするのに十分な割り当てがあることを確認します。割り当てと 使用量の上限を確認して管理するには、割り当てと割り当て アラートをご覧ください。2 つの API の違いに注意してください。
- Places SDK for iOS（旧版）の割り当ては、Places API サービスの割り当てに依存します。これは、すべての Places API メソッドの合計です。
- Places SDK for iOS（新版）の割り当ては、Places API（新版）サービスの割り当てに依存します。API メソッドごとに個別の割り当てがあります。
交渉済みの契約に Places API（新版）が含まれているかどうかを確認する
交渉済みの契約がある場合は、Places API（新版）が対象となっており、想定される料金が適用されていることを確認してください。そうでない場合は、Google の営業担当者またはパートナーに連絡して、この API を含める方法についてご相談ください。
全般的な変更点
複数の API に適用される一般的な変更点は次のとおりです。
新しい料金モデルを使用します。すべての API の料金については、Places SDK for iOS （新版）の 料金をご覧ください。
Place Details （新版）、 Nearby Search （新版）、 テキスト検索 （新版）では、レスポンスで返されるフィールドを指定するためにフィールド マスクが必要です。
GMSPlacesClientには、これらの新しい API を呼び出すための新しいメソッドが含まれています。新しい API へのリクエストを定義するために、新しいクラスが追加されました。
レスポンス
GMSPlaceインスタンスには、新しいreviewsプロパティ（型:GMSPlaceReview）が含まれています。 アプリがGMSPlaceインスタンスから取得した情報（写真やクチコミなど）を表示する場合は、必要な帰属表示も表示する必要があります。詳細については、 帰属表示に関するドキュメントをご覧ください。
API 固有の変更点
このセクションでは、各 API の移行ガイドについて説明します。