API バージョンの選択

Places API は 2 つの API バージョンをサポートしています。Places API は既存の API で、Places API（新）は次世代バージョンの API です。

Places API（新版）のリリース時の最初のタスクは、使用する API セットを決めることです。これは、新規のお客様か、すでに API を使用している既存のお客様の場合に該当します。このガイドでは、2 つの API の主な違いについて説明します。

API のリスト

次の表に、両方の API セットを示します。既存のお客様の場合は、この表で現在ご利用中の API の後継となる新しい API をご確認ください。

Places API Places API（新規） 注
Find Place テキスト検索（新版） Find Place の新しいバージョンはありません。 代わりにテキスト検索（新版）に切り替わりました。
Nearby Search Nearby Search（新版） Nearby Search（新版）はテキスト入力に対応していないため、テキストクエリを含む既存の API を使用するすべてのリクエストでは、テキスト検索（新版）を使用する必要があります。
テキスト検索 テキスト検索（新版）
Place Details Place Details（新規）
Place Photo Place Photo（新）
Place Autocomplete 予測入力（新）
Query Autocomplete 予測入力（新） 予測入力に追加された機能（新機能）

API キーで有効にした Places API サービスのバージョンによって、アプリで使用する API が制御されます。

  • Places API: 既存の API を有効にします。アプリで使用している API キーに関連付けられているプロジェクトで、Places API のみを有効にしている場合、アプリは新しい API にアクセスできません。

  • Places API（新版）: Places SDK for iOS（新版）に追加された主な機能で説明されている新しい API と機能をすべて有効にします。アプリは既存の API にアクセスできません。

  • 両方: Places SDK for iOS（新版）と Places SDK for iOS のすべての機能と API を有効にします。

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

新しい API に移行する

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

Places API に追加された主な機能（新規）

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

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

Places API（新版）は、Google Cloud のサービス インフラストラクチャに実装されています。この実装により、OAuth などの強化されたセキュリティ オプションを備えた、より安全で信頼性の高いプラットフォームを実現できます。この標準の API 設計により API 全体にある程度の一貫性がもたらされ、Places API（新版）での開発効率が向上します。

パフォーマンスの向上

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

シンプルな料金体系

Places API（新版）では料金体系がシンプルになり、実際に使用した分だけ料金が発生します。簡素化された料金体系は、フィールド マスクを使用して実装されています。

Place Details（新版）、Nearby Search（新版）、テキスト検索（新版）では、フィールド マスクを使用して、レスポンスで返されるフィールドのリストを制御します。リクエストしたデータに対してのみ課金されます。フィールド マスキングは、不要なデータをリクエストしないようにするための優れた設計プラクティスです。これにより、不要な処理時間と課金を回避できます。

場所に対する一貫したレスポンス データ

既存の API では、Place Details、Nearby Search、Text Search の各 API で返されるレスポンス データは、場所ごとに異なります。Places API（新版）では、レスポンスが標準化されており、これらの API のすべてが、ある場所について同じデータを返すようになっています。

拡張された場所のタイプ

API レスポンスに場所のプライマリ タイプを含めることができるようになりました。すべての場所には、表 A に示されているように、場所のメインタイプとして指定される単一のタイプ値を設定できます。

さらに、次の表に示す場所タイプも追加されます。これらの新しいタイプと既存のタイプは、Nearby 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

これらの新しいタイプに加えて、Places API（新版）では次のタイプも Places API のテーブル 2 から Places API（新版）のテーブル A に移動しました。つまり、以下の型を検索の一部として使用できるようになりました。

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality

動的な場所データ

Places API（新版）は、EV 充電スタンドの空き状況やガソリン スタンドの最新の燃料価格などの動的レスポンス データをサポートします。これらのレスポンス フィールドを使用して、動的なユーザー エクスペリエンスを作成します。

どの API を選択すればよいですか。

アプリ開発を始める前に、API を選択する必要があります。

  1. Places API を使い始めたばかりの新規のお客様は、新しい API から始めてください。

  2. 新規のお客様で、既存の API（Place Autocomplete や Query Autocomplete など）の代替機能がまだない場合は、新しい API と既存の API を組み合わせて使用できます。

  3. 既存のお客様は、引き続き既存の API を使用できます。ただし、Places API（新版）のパフォーマンス向上と機能強化を利用するには、新しい API に移行してください。

    移行の詳細については、移行の概要をご覧ください。