feat: Adds editorial summary (one-liners) to the reference docs. (#388)

Change-Id: I3e79a5e8da522e2bfd6b33d27b1402e07907c3a3

Author: willum070

dist/documentation/schemas/maps_http_schema_placeeditorialsummary.html

@@ -0,0 +1,17 @@
+<!--- This is a generated file, do not edit! -->
+<!--- [START maps_http_schema_placeeditorialsummary] -->
+<h3 class="schema-object" id="PlaceEditorialSummary">PlaceEditorialSummary</h3>
+
+Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.
+
+| Field                                                                                                          | Required | Type   | Description                                                                                                           |
+| :------------------------------------------------------------------------------------------------------------- | -------- | ------ | --------------------------------------------------------------------------------------------------------------------- |
+| <h4 id="PlaceEditorialSummary-language" class="add-link schema-object-property-key"><code>language</code></h4> | optional | string | <div class="nonref-property-description"><p>The language of the previous fields. May not always be present.</p></div> |
+| <h4 id="PlaceEditorialSummary-overview" class="add-link schema-object-property-key"><code>overview</code></h4> | optional | string | <div class="nonref-property-description"><p>A medium-length textual summary of the place.</p></div>                   |
+
+<p style="text-align: right; font-size: smaller;">Generated from the <a class="gc-analytics-event" data-category="GMP" data-label="openapi-github" href="https://github.com/googlemaps/openapi-specification" title="Google Maps Platform OpenAPI Specification" class="external">OpenAPI specification</a>.
+<a class="gc-analytics-event" data-category="GMP" data-label="openapi-github-maps-http-schema-placeeditorialsummary" data-action="edit" style="margin-left: 5px;" href="https://github.com/googlemaps/openapi-specification/blob/main/specification/schemas/PlaceEditorialSummary.yml" title="Edit on GitHub"><span class="material-icons">edit</span> Edit</a>
+<a class="gc-analytics-event" data-category="GMP" data-label="openapi-github-maps-http-schema-placeeditorialsummary" data-action="bug" style="margin-left: 5px;" href="https://github.com/googlemaps/openapi-specification/issues/new?assignees=&labels=type%3A+bug%2C+triage+me&template=bug_report.md&title=[schemas] Bug - PlaceEditorialSummary" title="File bug for schemas on GitHub"><span class="material-icons">bug_report</span> Report bug</a>
+</p>
+
+<!--- [END maps_http_schema_placeeditorialsummary] -->

dist/documentation/schemas/maps_http_schema_placeeditorialsummary.md

@@ -31,12 +31,8 @@ description: |
 
   **Atmosphere**
 
-  The Atmosphere category includes the following fields: `curbside_pickup`, `delivery`, `dine_in`, `price_level`, `rating`, `review`, `takeout`, `user_ratings_total`.
+  The Atmosphere category includes the following fields: `curbside_pickup`, `delivery`, `dine_in`, `editorial_summary`, `price_level`, `rating`, `review`, `takeout`, `user_ratings_total`.
 
-  <aside class="note"><strong>Note: </strong><code>curbside_pickup</code>, <code>delivery</code>,
-  <code>dine_in</code>, and <code>takeout</code> are only supported for Place Details requests.
-  </aside>
-  
 schema:
   type: array
   items:
@@ -59,4 +55,3 @@ examples:
   all:
     value: 
     - "*"
-    

specification/parameters/places/fields.yml

@@ -42,6 +42,9 @@ properties:
   dine_in:
     description: Specifies if the business supports indoor or outdoor seating options. 
     type: boolean
+  editorial_summary:
+    description: Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.
+    $ref: "./PlaceEditorialSummary.yml"
   formatted_address:
     description: |
       A string containing the human-readable address of this place.

specification/schemas/Place.yml

@@ -0,0 +1,24 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+type: object
+title: PlaceEditorialSummary
+description: Contains a summary of the place. A summary is comprised of a textual overview, and also includes the language code for these if applicable. Summary text must be presented as-is and can not be modified or altered.
+properties:
+  overview:
+    description: A medium-length textual summary of the place.
+    type: string
+  language:
+    description: The language of the previous fields. May not always be present.
+    type: string

specification/schemas/PlaceEditorialSummary.yml

@@ -135,6 +135,8 @@ PlaceAutocompleteStructuredFormat:
   $ref: "./PlaceAutocompleteStructuredFormat.yml"
 PlaceAutocompleteTerm:
   $ref: "./PlaceAutocompleteTerm.yml"
+PlaceEditorialSummary:
+  $ref: "./PlaceEditorialSummary.yml"
 PlacePhoto:
   $ref: "./PlacePhoto.yml"
 PlaceOpeningHours: