fix: adds locationrestriction param doc; updates location param doc (#363)

* fix: adds locationrestriction parameter; updates location parameter with note about radius parameter.

* chore: remove modified dist from pull request

Co-authored-by: googlemaps-bot <googlemaps-bot@google.com>
Co-authored-by: Angela Yu <5506675+wangela@users.noreply.github.com>

Author: 3 people

specification/parameters/_index.yml

@@ -82,6 +82,8 @@ places_location:
   $ref: "./places/location.yml"
 places_locationbias:
   $ref: "./places/locationbias.yml"
+places_locationrestriction:
+  $ref: "./places/locationrestriction.yml"
 places_maxheight:
   $ref: "./places/maxheight.yml"
 places_maxprice:

specification/parameters/places/locationbias.yml

@@ -30,4 +30,4 @@ examples:
   circular:
     value: circle:1000@37.781157,-122.398720
   rectangular:
-    value: rectangle:37.7,-122.4|37.8,-122.3
+    value: rectangle:37.7,-122.4|37.8,-122.3

specification/parameters/places/locationrestriction.yml

@@ -0,0 +1,27 @@
+# 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.
+
+name: locationrestriction
+description: |
+  Restrict results to a specified area, by specifying either a radius plus lat/lng, or two lat/lng pairs representing the points of a rectangle.
+  - Circular: A string specifying radius in meters, plus lat/lng in decimal degrees. Use the following format: `circle:radius@lat,lng`.
+  - Rectangular: A string specifying two lat/lng pairs in decimal degrees, representing the south/west and north/east points of a rectangle. Use the following format:`rectangle:south,west|north,east`. Note that east/west values are wrapped to the range -180, 180, and north/south values are clamped to the range -90, 90.
+schema:
+  type: string
+in: query
+examples:
+  circular:
+    value: circle:1000@37.781157,-122.398720
+  rectangular:
+    value: rectangle:37.7,-122.4|37.8,-122.3

specification/paths/places/autocomplete.yml

@@ -38,6 +38,7 @@ parameters:
   - "$ref": "../../parameters/places/origin.yml"
   - "$ref": "../../parameters/places/location.yml"
   - "$ref": "../../parameters/places/locationbias.yml"
+  - "$ref": "../../parameters/places/locationrestriction.yml"
   - "$ref": "../../parameters/places/radius.yml"
   - "$ref": "../../parameters/places/types.yml"
   - "$ref": "../../parameters/language.yml"
@@ -55,4 +56,4 @@ responses:
             value:
               $ref: "../../responses/maps_http_places_autocomplete_amoeba_strict_response.yml"
         schema:
-          $ref: "../../schemas/PlacesAutocompleteResponse.yml"
+          $ref: "../../schemas/PlacesAutocompleteResponse.yml"

specification/paths/places/findplacefromtext.yml

@@ -32,6 +32,7 @@ parameters:
     example: "Museum of Contemporary Art Australia"
   - "$ref": "../../parameters/places/inputtype.yml"
   - "$ref": "../../parameters/places/locationbias.yml"
+  - "$ref": "../../parameters/places/locationrestriction.yml"
   - "$ref": "../../parameters/language.yml"
 responses:
   "200":