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 を選択する必要があります。
Places API を使い始めたばかりの新規のお客様は、新しい API から始めてください。
新規のお客様で、既存の API(Place Autocomplete や Query Autocomplete など)の代替機能がまだない場合は、新しい API と既存の API を組み合わせて使用できます。
既存のお客様は、引き続き既存の API を使用できます。ただし、Places API(新版)のパフォーマンス向上と機能強化を利用するには、新しい API に移行してください。
移行の詳細については、移行の概要をご覧ください。