移行の概要

Places SDK for iOS(新版)では、パフォーマンスが向上し、新しい料金モデルが導入されています。そのため、Places SDK for iOS を使用するアプリを更新する価値は十分にあります。機能の比較について詳しくは、SDK を選択するをご覧ください。

このガイドでは、Places SDK for iOS(新版)と Places SDK for iOS の主な違いと、必要な変更の処理方法について説明します。

Places SDK for iOS(新規)を有効にする

Places SDK for iOS は、Places API サービスに依存しています。Places SDK for iOS(新版)の機能を利用するには、まず Google Cloud プロジェクトで Places API(新版)を有効にする必要があります。詳細については、Google Cloud プロジェクトを設定するをご覧ください。

アプリで使用する API キーに Places API (new) を追加しておく必要があります。詳しくは、API キーを使用するをご覧ください。

全般的な変更点

複数の API に適用される一般的な変更は次のとおりです。

  • 新しい料金モデルを採用している。すべての API の料金については、Places SDK for iOS(新版)の料金をご覧ください。

  • レスポンスで返すフィールドを指定するため、Place Details(新)Nearby Search(新)テキスト検索(新)では、フィールド マスキングが必要です。

  • GMSPlacesClient には、これらの新しい API を呼び出す新しいメソッドが含まれています。

  • 各新しい API へのリクエストを定義する新しいクラスが追加されました。

  • レスポンスの GMSPlace インスタンスには、GMSPlaceReview 型の新しい reviews プロパティが含まれています。アプリが GMSPlace インスタンスから取得した情報(写真やレビューなど)を表示する場合、必要なアトリビューションも表示する必要があります。

    詳細については、アトリビューションに関するドキュメントをご覧ください。

API 固有の変更

このセクションでは、各 API の次の移行ガイドについて説明します。