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 ごとに次の移行ガイドをご覧ください。
- Nearby Search(New)に移行する
- Text Search(New)に移行する
- Place Details に移行する(新規)
- Place Photo (New) に移行する
- オートコンプリート(新)に移行する
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 |
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 を組み合わせて使用できます。
既存のお客様は、既存の API を引き続き使用できます。ただし、Places API(New)のパフォーマンス向上と機能強化を利用するには、新しい API に移行してください。
移行の詳細については、移行の概要をご覧ください。