SDK バージョンの選択

次の場所で利用できる Places SDK for iOS の機能は、 使用している SDK のバージョン番号（9.0.0 など）と パッケージの依存関係で指定したものと、API キーで有効化されている API が含まれます。 このガイドでは、バージョンの違いと、バージョンの選択方法について説明します 各バージョンが有効になっていることを確認します

SDK バージョン番号

パッケージの依存関係で指定した SDK のバージョン番号 は、追加された機能にアプリがアクセスできるかどうかを 確認します。たとえば、予測入力（新）は SDK でのみ利用可能です バージョン 9.0.0 以降が必要です。

各 SDK バージョンでの変更点について詳しくは、プレイスに関するページ SDK for iOS リリースノートをご覧ください。

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

SDK のバージョン番号を指定するほか、プレイス オプションも選択する必要があります。 SDK が Google Cloud コンソールで呼び出す API サービス。Places API または Places API（新規）。SDK のバージョン番号とともに、使用する API サービスは [選択] では、アプリで利用できる特定の機能のバージョンを指定します。 予測入力や予測入力（新版）などの 追加機能を提供しています指定できる SDK は 1 つのみですが、 で、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 のバージョンを示します。 feature:

機能 API キーで Places API が有効化されました 最小 SDK バージョン
予測入力（新） Places API（新規） 9.0.0
Place Details（新規） Places API（新規） 9.0.0
Nearby Search（新版） Places API（新規） 9.0.0
Place Photos（新規） Places API（新規） 9.0.0
テキスト検索（新版） Places API（新規） 8.5.0
Place Autocomplete Places API 3.0.0
Current Place Places API 3.0.0
Place Details Places API 3.0.0
Place Photos Places API 3.0.0

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

  • Places SDK for iOS を初めて利用する場合: まずは Places API（新版）と新しい SDK です。
  • 既存のお客様の場合は、引き続き既存の SDK をご利用いただけます。 ただし、パフォーマンスの向上と Cloud Shell の Places SDK for iOS（新）の拡張版を使用する場合は、Places API を有効にして （新規）に移行し、新しい SDK を使用してください。Google Cloud 上の SDK バージョンと API を選択する手順 サービス。
  • Places API（新版）では、既存の一部の API が有効にならない Currents などの 場所、 GMSPlace.isOpen および GMSPlaceisOpenAtDate。

GooglePlacesSwift のプレビュー リリースを使用する

GooglePlacesSwift を使用する手順は次のとおりです。

  1. Places API を有効化 （新規）。
  2. 追加 GooglePlacesSwiftSDK 依存関係に追加します。
  3. プレイス クライアントを PlacesClient。

GooglePlacesSwift については、リファレンス ドキュメントをご覧ください。

新しい API に移行する

既存の API から新しい API に移行する場合は、 以下の移行ガイドを参照してください。

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

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

Google Cloud の標準プラットフォームに実装

Places SDK for iOS（新版）がサービスに実装されます インフラストラクチャ 説明しますこの実装により、より安全で信頼性の高いプラットフォームが実現します。 この標準的な設計により、SDK 間である程度の一貫性が保たれ、 Places SDK for iOS で開発を効率化 （新規）。

パフォーマンスの向上

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

新機能

Places SDK for iOS（新版）には、 すべての SDK 機能が含まれています。

シンプルな料金体系

Places SDK for iOS（新版）では料金がシンプルになり、 使用したデータに対してのみ料金が発生します。簡素化された料金設定は、フィールドを使用して実装されます。 フィールド マスクとも呼ばれます。

Places SDK for iOS と Text Search では、フィールド リストを使用して、 レスポンスで返すことができます。その場合、課金対象はデータに対してのみ 渡されます。フィールド リストの使用は、 リクエストできるため、不要な処理時間を回避し、 請求料金を管理できます。

両方の SDK の詳細な料金情報については、使用量と お支払い。

拡張された場所のタイプ

新しい SDK では、次の表に示す場所タイプが追加されています。これらの型は、 Place Details の一部として返されます。 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（新版）では次のタイプを移動しました。 を Places API の表 2 から Places API（新版）の表 A に変更します。 つまり、これらの型を search:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality