このページは Cloud Translation API によって翻訳されました。

API バージョンの選択

Places API は、次の 2 つの API バージョンをサポートしています。 Places API は、既存の API と Places API （新規）が次の API の世代によって異なります。

Places API（新版）のリリース時に、最初に行うタスクは、使用する API のセットです。これは、新規のお客様か既存のお客様かに当てはまります。 API を使用している顧客ですこのガイドを使用して、Google Cloud の 2 つの API の違いについて説明します。

API のリスト

次の表に、両方の API セットを示します。既存のお客様の場合この表を使用して、現在使用している API を置き換える新しい API を確認してください。確認できます。

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

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

Places API: 既存の API を有効にします。必要な場合のみ Places API が関連付けられているプロジェクトで、新しい API にアクセスすることはできません。
Places API（新版）: すべての新しい API と主な機能の追加 Places SDK for iOS（新規）をご覧ください。アプリはアクセスできるようになります。
両方: 両方の機能と API をすべて有効にする Places SDK for iOS（新版）と Places SDK for iOS。

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

新しい API に移行する

既存の API から新しい API に移行する場合は、以下の移行ガイドを参照してください。

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

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

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

Places API（新版）はサービスインフラストラクチャ説明しますこの実装により、セキュリティと信頼性の Google Cloud などの高度なセキュリティオプションを OAuth。この標準 API API 間である程度の一貫性が保たれ、効率が向上します。。

パフォーマンスの向上

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

シンプルな料金体系

Places API（新版）により料金体系がシンプルになり、使用した分の料金のみが請求されます。簡素化された料金設定は、フィールドマスク。

Place Details（新版）を使用した場合、 Nearby Search（新版）テキスト検索（新版）では、フィールドマスクを使用してレスポンスで返されるフィールドのリスト。その場合、課金対象はデータに対してのみ渡されます。フィールドマスキングを使用すると、不要なデータをリクエストしないため、不要な処理時間を回避できます。料金を管理できます。

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

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

拡張された場所のタイプ

API レスポンスに場所のプライマリタイプを含めることができるようになりました。あらゆる場所で場所のメインのタイプとして指定される単一のタイプ値。表 A.

さらに、次の表に示す場所タイプも追加されます。Google Chat ではこれらの新しい型と既存の型を、 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
コンサルタント	ヘリポート	遊び場	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（新版）では次のタイプを移動しました。を Places API の表 2 から Places API（新版）の表 A に変更します。つまり、これらの型を search:

country
administrative_area_level_1
administrative_area_level_2
postal_code
locality

動的な場所データ

Places API（新版）は、空き状況などの動的なレスポンスデータに対応しています。 EV 充電スタンドの営業時間やガソリンスタンドの最新の燃料価格などです。使用動的ユーザーエクスペリエンスを構築します

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

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

Places API を初めて利用する新規のお客様は、新しい API から始めます。
新規のお客様で、まだ交換用デバイスをお持ちではない場合 Place Autocomplete や Query などの既存の API 予測入力。新しい API と既存の API を組み合わせて使用できます。
既存のお客様は、引き続き既存の APIただし、パフォーマンスの向上と Google Cloud の機能拡張がリリースされたため、説明します。

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