新しい Place Details、Nearby Search、Text Search の各 API のレスポンス形式が、既存の API の形式から変更されました。主な違いは、レスポンスの Place オブジェクトの変更点で説明されているように、各メソッドから返される Place
オブジェクトの形式です。
また、レスポンス オブジェクトの最上位フィールドも API ごとに変更されています。詳しくは、以下をご覧ください。
レスポンスの Place オブジェクトに対する変更
次の表は、Place Details(New)、Nearby Search(New)、Text Search(New)のレスポンスの新しい
Place
オブジェクトの変更点を、既存の
Place
オブジェクトと比較したものです。
新しいレスポンス オブジェクトでは、フィールド名にキャメルケースが使用されます。新しいフィールドが追加され、一部の既存のフィールドの名前が変更されます。
項目 | 既存のプレイス オブジェクト | 新しいプレイス オブジェクト | メモ |
---|---|---|---|
住所コンポーネント | address_components |
addressComponents |
|
microformat による住所の場所 | adr_address |
adrFormatAddress |
|
ビジネス ステータス | business_status |
businessStatus |
|
来週の営業時間 | current_opening_hours |
currentOpeningHours |
|
編集者による概要 | editorial_summary |
editorialSummary |
|
書式設定された住所 | formatted_address |
formattedAddress |
|
国内の電話番号 | formatted_phone_number |
nationalPhoneNumber |
|
ロケーション | geometry.location |
location |
|
ビューポート | geometry.viewport |
viewport |
|
場所の帰属情報 | html_attributions |
attributions |
既存の API のレスポンスの最上位フィールド |
アイコンの URL | icon |
削除しました。iconMaskBaseUri と iconBackgroundColor を使用します。詳しくは、場所アイコンをご覧ください。 |
|
アイコンの背景色 | icon_background_color |
iconBackgroundColor |
|
アイコンマスクの URL | icon_mask_base_uri |
iconMaskBaseUri |
|
国際電話番号 | international_phone_number |
internationalPhoneNumber |
|
テキストの場所の名前 | name |
displayName |
テキストの場所の名前が displayName.text として、language として displayName.languageCode としてアクセスできるようになりました。 |
営業時間 | opening_hours |
regularOpeningHours |
|
写真 | photos |
photos |
新しい Place オブジェクトでは photos の形式が変更されました。詳しくは、写真の参照に関する変更をご覧ください。 |
プレイス ID | place_id |
id |
|
Plus Code | plus_code |
plusCode |
|
価格帯 | price_level |
priceLevel |
|
評価 | rating |
rating |
|
クチコミ | reviews |
reviews |
|
本日から翌週のサブの営業時間(例外とその他すべてのデータを除く) | secondary_opening_hours |
currentSecondaryOpeningHours |
|
場所タイプ | types |
types |
|
場所の Google マップ URL | url |
googleMapsUri |
|
ユーザーの評価数 | user_ratings_total |
userRatingCount |
|
UTC オフセット | utc_offset |
utcOffsetMinutes |
|
住所の短縮形(町名や番地を含む) | vicinity |
shortFormattedAddress |
|
ウェブサイト | website |
websiteUri |
|
車椅子対応状況に関する情報 | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance の現在時刻は accessibilityOptions.wheelchairAccessibleEntrance です |
場所の属性 | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
リソース名 | places/PLACE_ID 形式の name フィールド |
既存の API では、name フィールドに場所の名前がテキスト文字列として含まれていました。新しい API では、この情報は displayName にあります。 |
|
場所のメインのタイプ | primaryTypeName |
新規 | |
メインのタイプをテキスト文字列として配置する | primaryTypeDisplayName |
新規 | |
通常の週次第 2 営業時間(例外とその他すべてのデータを除く) | regularSecondaryOpeningHours |
新規 | |
その場所でご利用いただけるお支払い方法 | paymentOptions |
新規 | |
駐車場オプション | parkingOptions |
新規 | |
場所に関連するサブの目的地のリスト | subDestinations |
新規 | |
ガソリン スタンドの燃料オプションに関する最新情報 | fuelOptions |
新規 | |
EV 充電スタンドの情報 | evChargeOptions |
新規 | |
場所の属性 | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
新規 |
Text Search レスポンスの変更
次の表に、既存の Text Search のレスポンス オブジェクトと Text Search(New)のレスポンス オブジェクトの最上位フィールドに対する変更を示します。新しい API の場合、レスポンスの最上位フィールドは places
配列のみです。
項目 | Text Search(既存) | テキスト検索(新版) | メモ |
---|---|---|---|
場所の帰属情報 | html_attributions |
place.attributions として各場所の新しい Place オブジェクトに移動しました |
|
場所の配列 | 既存の Place オブジェクトの results 配列 |
新しい Place オブジェクトの places 配列 |
|
リクエストのステータス | status |
標準の HTTP レスポンス(HTTP レスポンス コードとメッセージ)に移動 | |
エラー メッセージ | error_message |
標準の HTTP レスポンス(HTTP レスポンス コードとメッセージ)に移動 | |
情報メッセージ | info_messages |
削除済み | |
ページトークン | next_page_token |
削除済み |
Nearby Search レスポンスの変更
次の表は、既存の Nearby Search のレスポンス オブジェクトと Nearby Search(New)のレスポンス オブジェクトの最上位フィールドに対する変更を示しています。新しい API の場合、レスポンスの最上位のフィールドは places
配列のみです。
項目 | Nearby Search(既存) | Nearby Search(New) | メモ |
---|---|---|---|
場所の帰属情報 | html_attributions |
place.attributions として各場所の新しい Place オブジェクトに移動しました。 |
|
場所の配列 | 既存の Place オブジェクトの results 配列 |
新しい Place オブジェクトの places 配列 |
|
リクエストのステータス | status |
標準の HTTP レスポンス(HTTP レスポンス コードとメッセージ)に移動 | |
エラー メッセージ | error_message |
標準の HTTP レスポンス(HTTP レスポンス コードとメッセージ)に移動 | |
情報メッセージ | info_messages |
削除済み | |
ページトークン | next_page_token |
削除済み |
Place Details レスポンスの変更
次の表は、既存の Place Details のレスポンス オブジェクトと Place Details (New) のレスポンス オブジェクトの最上位フィールドの変更点を示しています。新しい API の場合、レスポンスの最上位のフィールドは places
配列のみです。
項目 | Place Details(既存) | Place Details(新規) | メモ |
---|---|---|---|
場所の帰属情報 | html_attributions |
attributions として新しい Place オブジェクトに移動しました。 |
|
場所の詳細 | 既存の Place オブジェクトを含む result |
新しい Place オブジェクト | |
リクエストのステータス | status |
標準の HTTP レスポンス(HTTP レスポンス コードとメッセージ)に移動 | |
情報メッセージ | info_messages |
標準の HTTP レスポンス(HTTP レスポンス コードとメッセージ)に移動 |