移行の概要

Places SDK for iOS(新規)は、パフォーマンスの向上と新しい料金モデルを備えており、Places SDK for iOS を使用するアプリを更新する価値があります。機能の比較の詳細については、SDK を選択するをご覧ください。

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

移行の請求に関するベスト プラクティス

このガイダンスは、API の使用量が 2 番目の料金階層に移行するほど多い場合に適用されます。新しいバージョンの API に移行すると、別の SKU でも課金されます。移行月の費用増加を回避するため、本番環境で新しい API にできるだけ早く切り替えることをおすすめします。これにより、移行月中に最も費用対効果の高い月額料金階層に達することができます。料金階層については、料金ページ料金に関するよくある質問をご覧ください。

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

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

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

全般的な変更点

複数の API に適用される一般的な変更には、次のようなものがあります。

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

  • Place Details(新版)Nearby Search(新版)Text Search(新版) では、レスポンスで返されるフィールドを指定するために、フィールド マスキングが必要です。

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

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

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

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

API 固有の変更

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