新しいメッセージのレスポンス形式
Place Details、
Nearby Search、
および
テキスト検索
API が既存の API の形式から変更されました。主な違いは
各メソッドから返される Place オブジェクトの形式。詳細については、
レスポンスの Place オブジェクトの変更。
さらに、レスポンス オブジェクトの最上位フィールドには、 API ごとに変更できます。参照:
レスポンスの Place オブジェクトの変更点
次の表は、新しい
Place オブジェクト
Place Details (New) のレスポンスで、
Nearby Search（新版）
既存と比較したテキスト検索（新版）
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 |
photos の形式が新しい
Place オブジェクト。詳細については、次をご覧ください:
写真の参照の変更。 |
| プレイス 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 |
新規 | |
| メインのタイプをテキスト文字列として配置する | primaryTypeDisplayName |
新規 | |
| 通常の週の第 2 営業時間（例外とその他すべて） データ | regularSecondaryOpeningHours |
新規 | |
| 対応している支払い方法 | paymentOptions |
新規 | |
| 場所の駐車場オプション | parkingOptions |
新規 | |
| 場所に関連するサブデスティネーションのリスト | subDestinations |
新規 | |
| ガソリン スタンドの燃料オプションに関する最新情報 | fuelOptions |
新規 | |
| 特定の場所の EV 充電情報 | evChargeOptions |
新規 | |
| 場所の属性 | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
新規 |
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 オブジェクトの results 配列 |
新しい値の places 配列
Place オブジェクト |
|
| リクエストのステータス | status |
標準の HTTP レスポンス（HTTP レスポンス コードとメッセージ）に移動 | |
| エラー メッセージ | error_message |
標準の HTTP レスポンス（HTTP レスポンス コードとメッセージ）に移動 | |
| 情報メッセージ | info_messages |
削除済み | |
| ページトークン | next_page_token |
削除済み |
Place Details のレスポンスの変更
次の表は、レスポンスの最上位フィールドの変更点を示しています。
オブジェクト
を、既存の Place Details と response の
オブジェクト
をご覧ください。新しい API では、
レスポンスは places 配列です。
| 項目 | Place Details（既存） | Place Details（新規） | メモ |
|---|---|---|---|
| 帰属情報を配置する | html_attributions |
新しい場所に移動した
オブジェクト（attributions として） |
|
| 場所の詳細 | 既存の Place オブジェクトを含む result |
新しい Place オブジェクト | |
| リクエストのステータス | status |
標準の HTTP レスポンス（HTTP レスポンス コードとメッセージ）に移動 | |
| 情報メッセージ | info_messages |
標準の HTTP レスポンス（HTTP レスポンス コードとメッセージ）に移動 |