SDK バージョンの選択

アプリで使用できる Places SDK for iOS の機能は、パッケージの依存関係で指定した SDK バージョン番号（9.0.0 など）と、API キーで有効にした API の組み合わせによって決まります。このガイドでは、バージョンの違いと、アプリで有効にするバージョンを選択する方法について説明します。

SDK バージョン番号

パッケージの依存関係で指定する SDK のバージョン番号によって、アプリが特定のリリースで追加された機能にアクセスできるかどうかが決まります。たとえば、自動入力（新規）は SDK バージョン 9.0.0 以降でのみ使用できます。

各 SDK バージョンで導入された変更について詳しくは、Places SDK for iOS リリースノートをご覧ください。

Places SDK for iOS の Places API のバージョン

SDK バージョン番号を指定するだけでなく、Google Cloud コンソールで SDK が呼び出す Places API サービス（Places API または Places API（新規））も選択する必要があります。アプリで使用できる特定の機能のバージョン（自動入力や自動入力（新規）など）は、SDK バージョン番号と選択した API サービスによって決まります。指定できる SDK バージョン番号は 1 つだけですが、API キーで Places API と Places API（新規）の両方を同時に有効にできます。ただし、ほとんどの場合、Places API（新規）を有効にして、アプリで SDK 機能の（新規）バージョンを使用することをおすすめします。

SDK バージョンと API サービスを選択する

アプリで使用できる SDK の機能を選択するには、次の操作を行います。

  1. Google Cloud プロジェクトで、Places API、Places API（新規）、またはその両方を有効にします。詳細については、API を有効にするをご覧ください。
  2. API キーの制限で、Places API、Places API（新規）、またはその両方を有効にします。詳細については、API キーの制限をご覧ください。
  3. SDK をインストールするときに、バージョン番号を指定します。詳細については、Xcode プロジェクトをセットアップするをご覧ください。

Places API サービスの選択の詳細については、Google Cloud プロジェクトを設定するをご覧ください。

各バージョンで利用できる SDK 機能

次の表に、各 SDK 機能に必要な SDK と API のバージョンを示します。

Places SDK for iOS（新規） 最小 SDK バージョン Places SDK for iOS 最小 SDK バージョン
Place Details（新規） 9.0.0 Place Details 3.0.0
Place Photo (New) 9.0.0 Place Photo 3.0.0
テキスト検索（新規） 8.5.0
Nearby Search（新規） 9.0.0
Autocomplete（新規） 9.0.0 予測入力 3.0.0
Current Place 3.0.0

有効にするバージョンを選択する際の考慮事項

  • Places SDK for iOS を初めて使用する場合は、Places API（新規）と新しい SDK から始めてください。
  • 既存のお客様は、既存の SDK を引き続き使用できます。ただし、Places SDK for iOS（新規）のパフォーマンスの向上と機能の強化を活用するには、Places API（新規）を有効にして新しい SDK を使用する必要があります。新しい SDK に移行する際に移行する必要はありません。SDK バージョンと API サービスを選択するの手順に沿って操作してください。
  • Places API（新規）では、現在の場所、GMSPlace.isOpen、GMSPlace.isOpenAtDate などの既存の機能は使用できません。

iOS 向け Places Swift SDK（プレビュー版）を使用する

Places Swift SDK for iOS（プレビュー版）を使用するには、次の手順が必要です。

  1. Places API（新版）を有効にします。
  2. 依存関係に Places Swift SDK for iOS（プレビュー版）を追加します。
  3. PlacesClient を使用してプレイス クライアントを初期化します。

Places Swift SDK for iOS（プレビュー版）の詳細については、概要または移行ガイドをご覧ください。

新しい API に移行する

既存の API を使用していて、新しい API に移行する場合は、各 API の次の移行ガイドをご覧ください。

Places SDK for iOS の機能強化（新規）

このセクションでは、Places SDK for iOS に追加された主な機能について説明します（新規）。

Google Cloud 標準プラットフォームに実装されている

Places SDK for iOS（新規）は、Google Cloud のサービス インフラストラクチャに実装されています。この実装により、より安全で信頼性の高いプラットフォームが実現します。この標準設計により、SDK 全体に一貫性がもたらされ、Places SDK for iOS（新規）での開発効率が向上します。

パフォーマンスの向上

Places SDK for iOS（新規）はパフォーマンスが向上しているため、既存の SDK を使用するアプリを置き換える価値があります。

新機能

Places SDK for iOS（新規）には、次のすべての SDK 機能の最新バージョンが含まれています。

シンプルな料金体系

Places SDK for iOS（新規）では料金が簡素化され、使用したデータに対してのみ料金が発生します。シンプルな料金体系は、フィールドリスト（フィールド マスク）を使用して実装されます。

Places SDK for iOS とテキスト検索では、フィールドリストを使用して、レスポンスで返されるフィールドのリストを制御します。リクエストされたデータに対してのみ課金されます。フィールドリストを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と請求料金を回避できます。

両方の SDK の料金の詳細については、使用量と課金をご覧ください。

拡張されたプレイスタイプ

新しい SDK では、次の表に示すプレイスタイプが追加されています。これらのタイプは、Place Details と Text Search のレスポンスの一部として返されます。これらの新しいタイプと既存のタイプは、Text Search での検索でも使用できます。新しいタイプは 表 A に記載されています。

タイプ
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant farm korean_restaurant sporting_goods_store
barber_shop ファームステイ lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal 短縮 steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant テーラー
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant モーテル thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
コンサルタント ヘリポート 遊び場 vegetarian_restaurant
convention_center hiking_area 保育園 vietnamese_restaurant
コテージ historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center ホステル resort_hotel 卸売業者
dental_clinic ホテル rest_stop

これらの新しいタイプに加えて、Places API (New) では、次のタイプが Places API の表 2 から Places API (New) の表 A に移動されました。つまり、検索の一部として次のタイプを使用できるようになりました。

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality