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 を使用するリクエストでは、Text Search（新版）を使用する必要があります。 |
| テキスト検索 | テキスト検索（新規） | |
| Place Details | Place Details（新規） | |
| Place Photo | Place Photo (New) | |
| Place Autocomplete | Autocomplete（新規） | |
| クエリ オートコンプリート | Autocomplete（新規） | 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 の次の移行ガイドをご覧ください。
- Nearby Search（新規）に移行する
- Text Search（新規）に移行する
- Place Details に移行する（新規）
- Place Photo（新規）に移行する
- Autocomplete に移行する（新規）
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（新版）、Text Search（新版）では、フィールド マスクを使用して、レスポンスで返されるフィールドのリストを制御します。リクエストされたデータに対してのみ課金されます。フィールド マスキングを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と課金料金を回避できます。
場所の一貫したレスポンス データ
既存の API では、Place Details API、Nearby Search API、Text Search API は、場所に対して異なるレスポンス データを返していました。Places API（新規）ではレスポンスが標準化されているため、これらの API はすべて、場所について同じデータを返します。
拡張されたプレイスタイプ
API レスポンスに、場所のプライマリ タイプを含めることができるようになりました。すべての場所には、表 A に示すように、場所の主なタイプとして指定される単一のタイプ値を設定できます。
また、新しい API では、次の表に示す場所の種類が追加されています。これらの新しいタイプと既存のタイプは、Nearby 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 に移動されました。つまり、検索の一部として次のタイプを使用できるようになりました。
countryadministrative_area_level_1administrative_area_level_2postal_codelocality
動的場所データ
Places API（新規）は、EV 充電スタンドの空き状況やガソリン スタンドの最新の燃料価格などの動的レスポンス データをサポートしています。これらのレスポンス フィールドを使用して、動的ユーザー エクスペリエンスを作成します。
どの API を選択しますか？
アプリの開発を開始する前に、使用する API を選択する必要があります。
Places API を初めて使用する新規のお客様は、新しい API から始めてください。
新規のお客様で、既存の API（Place Autocomplete や Query Autocomplete など）の代替 API がまだない場合は、新しい API と既存の API を組み合わせて使用できます。
既存のお客様は、既存の API を引き続き使用できます。ただし、Places API（新規）のパフォーマンスの向上と機能の強化を活用するには、新しい API に移行することをおすすめします。
移行の詳細については、移行の概要をご覧ください。