API バージョンの選択

Places API では、2 つの API バージョンがサポートされています。Places API は既存の API で、Places API (New) は次世代バージョンの API です。

Places API（New）のリリースでは、まず使用する API のセットを決定します。これは、新規のお客様、またはすでに API を使用している既存のお客様の場合に該当します。このガイドでは、2 つの API の主な違いについて説明します。

API のリスト

次の表に、両方の API セットを示します。既存のお客様の場合は、次の表を使用して、現在使用している API に代わる新しい API を判断してください。

Places API Places API（新規） 注
Find Place テキスト検索（新） Find Place の新しいバージョンはありません。 Text Search (New) に置き換わりました。
Nearby Search Nearby Search（New） Nearby Search（New）はテキスト入力をサポートしていないため、テキストクエリを含む既存の API を使用するすべてのリクエストでは、Text Search (New) を使用する必要があります。
テキスト検索 テキスト検索（新）
Place Details Place Details（New）
Place Photo Place Photo（New）
Place 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（New）に追加された主な機能について説明します。

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

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

パフォーマンスの向上

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

シンプルな料金体系

Places API（新機能）では料金体系が簡素化されており、使用したデータに対してのみ料金が発生します。簡素化された料金は、フィールド マスクを使用して実装されます。

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

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

既存の API では、Place Details、Nearby Search、Text Search の各 API は、場所に対して異なるレスポンス データを返していました。Places API（新規）はレスポンスを標準化し、これらの API が場所に対して同じデータを返すようにします。

展開された場所のタイプ

API レスポンスに場所の primary type が含まれるようになりました。すべての場所には、表 A に記載されているように、場所の主なタイプとして指定された単一のタイプ値があります。

また、新しい API では、以下の表に示す場所タイプが追加されます。これらの新しいタイプと既存のタイプは、Nearby Search（New）と Text Search（New）の検索で使用できます。新しいタイプはすべてテーブル 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（New）では、表 A から表 B から以下のタイプを移動しました。つまり、検索の一部として次のタイプを使用できるようになりました。
  • 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 と既存の API を組み合わせて使用できます。

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

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