新しい Place Details、Nearby Search、Text Search API のレスポンス形式が、既存の API の形式から変更されました。主な違いは、レスポンスの Place オブジェクトの変更点で説明されているように、各メソッドから返される Place
オブジェクトの形式です。
また、レスポンス オブジェクトの最上位フィールドも API ごとに変更されています。詳しくは、以下をご覧ください。
レスポンスの Place オブジェクトの変更点
次の表は、Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)のレスポンスに含まれる新しい Place
オブジェクトと、既存の Place
オブジェクトの変更点を比較したものです。
新しいレスポンス オブジェクトは、フィールド名にキャメルケースを使用し、新しいフィールドを含み、既存のフィールドの一部の名前を変更します。
項目 | 既存のプレイス オブジェクト | 新しい場所オブジェクト | メモ |
---|---|---|---|
住所コンポーネント | address_components |
addressComponents |
|
マイクロフォーマットの住所を表示する | 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 |
|
本日からの翌週の第 2 の営業時間(例外とその他すべてのデータを除く) | 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 |
New | |
メインのタイプをテキスト文字列として配置する | primaryTypeDisplayName |
New | |
通常の週の第 2 営業時間(例外とその他すべてのデータを除く) | regularSecondaryOpeningHours |
New | |
対応している支払い方法 | paymentOptions |
New | |
場所の駐車場オプション | parkingOptions |
New | |
場所に関連するサブデスティネーションのリスト | subDestinations |
New | |
ガソリン スタンドの燃料オプションに関する最新情報 | fuelOptions |
New | |
特定の場所の EV 充電情報 | evChargeOptions |
New | |
場所の属性 | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
New |
Text Search の回答の変更
次の表は、既存の Text Search 用のレスポンス オブジェクトと、テキスト検索(新版)用のレスポンス オブジェクトの最上位フィールドの変更点を示しています。新しい API の場合、レスポンスの最上位フィールドは places
配列のみです。
項目 | テキスト検索(既存) | テキスト検索(新版) | メモ |
---|---|---|---|
帰属情報を配置する | 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(新版)用のレスポンス オブジェクトの最上位フィールドの変更点を示しています。新しい API の場合、レスポンスの最上位フィールドは places
配列のみです。
項目 | Nearby Search(既存) | Nearby Search(新版) | メモ |
---|---|---|---|
帰属情報を配置する | 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 レスポンス コードとメッセージ)に移動 |