Places SDK for iOS バージョン 8.5.0 は 2 つの SDK バージョンをサポートしています。Places SDK for iOS は、既存の Places SDK for iOS(New)です。次世代バージョンの SDK です。
Places SDK for iOS バージョン 8.5.0 のリリースでは、まず使用する SDK を決める必要があります。これは、SDK を初めて使用するお客様や既存のお客様の場合に該当します。このガイドでは、2 つの SDK の主な違いについて説明します。
SDK バージョンの選択方法
Places SDK for iOS は、Places API サービスに依存します。Places SDK for iOS を使用するには、Google Cloud プロジェクトで Places API サービスを有効にする必要があります。
有効にした Places API サービスのバージョンは、アプリで使用する SDK のバージョンをコントロールします。
Places API: 既存の Places SDK for iOS を有効にします。アプリで使用する API キーに関連付けられているプロジェクトで Places API のみが有効になっている場合、Places SDK for iOS バージョン 8.5.0 以降で追加された新機能にはアクセスできません。
Places API (New): Places SDK for iOS(新規)を有効にします。これには、Text Search や、Places SDK for iOS に追加された主な機能(新規)に記載されているすべての新機能が含まれます。既存の機能(Place Details、Place Photos、Current Place、Place Autocomplete など)は有効になりません。
両方: Places SDK for iOS(新)と Places SDK for iOS の両方のすべての機能を有効にします。
Places API サービスの選択について詳しくは、Google Cloud プロジェクトをセットアップするをご覧ください。
どの SDK を選択しますか。
どちらのバージョンを選ぶかを決めるには:
Places SDK for iOS を初めて使用する新規のお客様の方は、まずは Places API (New) と Places API の両方をお試しください。これにより、すべての機能をご利用いただけます。
既存のお客様は、引き続き既存の SDK を使用できます。ただし、新しい SDK を使用すると、Places SDK for iOS(新機能)のパフォーマンス向上と機能強化を利用できます。
新しい SDK に移行する必要はありません。必要な作業は、アプリで使用している API キーで Places SDK for iOS(新規)を有効にすることのみです。既存の Places SDK for iOS と Places SDK for iOS(新規)の両方を使用している場合は、API キーで両方のバージョンを有効にします。詳しくは、API キーを使用するをご覧ください。
Places SDK for iOS に追加された主な機能(新)
このセクションでは、Places SDK for iOS(New)に追加された主な機能について説明します。
Google Cloud 標準プラットフォームに実装
Places SDK for iOS(新規)は、Google Cloud のサービス インフラストラクチャに実装されています。この実装により、プラットフォームの安全性と信頼性が高まります。 この標準設計は SDK 全体にある程度の一貫性をもたらし、Places SDK for iOS(新)の開発効率を高めます。
パフォーマンスの向上
Places SDK for iOS(新): パフォーマンスが向上しているため、既存の SDK を使用しているアプリを置き換える価値があります。
新しい Text Search サービス
テキスト検索は、文字列に基づいて場所のセットに関する情報を返します。たとえば、「渋谷 ピザショップ」や「新宿近くの靴店」、「中央通り 123 番地」などを返します。このサービスは、テキスト文字列と設定した場所のバイアスに一致する場所のリストを返します。
シンプルな料金体系
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 |
コンサルタント | ヘリポート | playground | 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 | hotel | rest_stop |
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality