@googlemaps/places 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.1.0](https://github.com/googleapis/google-cloud-node/compare/places-v1.0.1...places-v1.1.0) (2023-10-24)
+
+
+### Features
+
+* [places] new features for Places GA ([#4756](https://github.com/googleapis/google-cloud-node/issues/4756)) ([5430bbf](https://github.com/googleapis/google-cloud-node/commit/5430bbfac12cac791e96e3411165d3f1d1ada3ae))
+
 ## [1.0.1](https://github.com/googleapis/google-cloud-node/compare/places-v1.0.0...places-v1.0.1) (2023-09-06)
 
 

package/README.md

@@ -93,6 +93,9 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 
 | Sample                      | Source Code                       | Try it |
 | --------------------------- | --------------------------------- | ------ |
+| Places.get_photo_media | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.get_photo_media.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.get_photo_media.js,packages/google-maps-places/samples/README.md) |
+| Places.get_place | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.get_place.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.get_place.js,packages/google-maps-places/samples/README.md) |
+| Places.search_nearby | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.search_nearby.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.search_nearby.js,packages/google-maps-places/samples/README.md) |
 | Places.search_text | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/generated/v1/places.search_text.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/generated/v1/places.search_text.js,packages/google-maps-places/samples/README.md) |
 | Quickstart | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-maps-places/samples/quickstart.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-maps-places/samples/quickstart.js,packages/google-maps-places/samples/README.md) |
 

package/build/protos/google/maps/places/v1/attribution.proto

@@ -0,0 +1,46 @@
+// Copyright 2023 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/api/field_behavior.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "AttributionProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// Information about the author of the UGC data. Used in
+// [Photo][google.maps.places.v1.Photo], and
+// [Review][google.maps.places.v1.Review].
+message AuthorAttribution {
+  // Output only. Name of the author of the [Photo][google.maps.places.v1.Photo]
+  // or [Review][google.maps.places.v1.Review].
+  string display_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. URI of the author of the [Photo][google.maps.places.v1.Photo]
+  // or [Review][google.maps.places.v1.Review].
+  string uri = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Profile photo URI of the author of the
+  // [Photo][google.maps.places.v1.Photo] or
+  // [Review][google.maps.places.v1.Review].
+  string photo_uri = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+}

package/build/protos/google/maps/places/v1/ev_charging.proto

@@ -0,0 +1,111 @@
+// Copyright 2023 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "EvChargingProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// Information about the EV Charge Station hosted in Place.
+// Terminology follows
+// https://afdc.energy.gov/fuels/electricity_infrastructure.html One port
+// could charge one car at a time. One port has one or more connectors. One
+// station has one or more ports.
+message EVChargeOptions {
+  // EV charging information grouped by [type, max_charge_rate_kw].
+  // Shows EV charge aggregation of connectors that have the same type and max
+  // charge rate in kw.
+  message ConnectorAggregation {
+    // The connector type of this aggregation.
+    EVConnectorType type = 1;
+
+    // The static max charging rate in kw of each connector in the aggregation.
+    double max_charge_rate_kw = 2;
+
+    // Number of connectors in this aggregation.
+    int32 count = 3;
+
+    // Number of connectors in this aggregation that are currently available.
+    optional int32 available_count = 4;
+
+    // Number of connectors in this aggregation that are currently out of
+    // service.
+    optional int32 out_of_service_count = 5;
+
+    // The timestamp when the connector availability information in this
+    // aggregation was last updated.
+    google.protobuf.Timestamp availability_last_update_time = 6;
+  }
+
+  // Number of connectors at this station. However, because some ports can have
+  // multiple connectors but only be able to charge one car at a time (e.g.) the
+  // number of connectors may be greater than the total number of cars which can
+  // charge simultaneously.
+  int32 connector_count = 1;
+
+  // A list of EV charging connector aggregations that contain connectors of the
+  // same type and same charge rate.
+  repeated ConnectorAggregation connector_aggregation = 2;
+}
+
+// See http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 for
+// additional information/context on EV charging connector types.
+enum EVConnectorType {
+  // Unspecified connector.
+  EV_CONNECTOR_TYPE_UNSPECIFIED = 0;
+
+  // Other connector types.
+  EV_CONNECTOR_TYPE_OTHER = 1;
+
+  // J1772 type 1 connector.
+  EV_CONNECTOR_TYPE_J1772 = 2;
+
+  // IEC 62196 type 2 connector. Often referred to as MENNEKES.
+  EV_CONNECTOR_TYPE_TYPE_2 = 3;
+
+  // CHAdeMO type connector.
+  EV_CONNECTOR_TYPE_CHADEMO = 4;
+
+  // Combined Charging System (AC and DC). Based on SAE.
+  //  Type-1 J-1772 connector
+  EV_CONNECTOR_TYPE_CCS_COMBO_1 = 5;
+
+  // Combined Charging System (AC and DC). Based on Type-2
+  // Mennekes connector
+  EV_CONNECTOR_TYPE_CCS_COMBO_2 = 6;
+
+  // The generic TESLA connector. This is NACS in the North America but can be
+  // non-NACS in other parts of the world (e.g. CCS Combo 2 (CCS2) or GB/T).
+  // This value is less representative of an actual connector type, and more
+  // represents the ability to charge a Tesla brand vehicle at a Tesla owned
+  // charging station.
+  EV_CONNECTOR_TYPE_TESLA = 7;
+
+  // GB/T type corresponds to the GB/T standard in China. This type covers all
+  // GB_T types.
+  EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T = 8;
+
+  // Unspecified wall outlet.
+  EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET = 9;
+}

package/build/protos/google/maps/places/v1/fuel_options.proto

@@ -0,0 +1,109 @@
+// Copyright 2023 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/protobuf/timestamp.proto";
+import "google/type/money.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "FuelOptionsProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// The most recent information about fuel options in a gas station. This
+// information is updated regularly.
+message FuelOptions {
+  // Fuel price information for a given type.
+  message FuelPrice {
+    // Types of fuel.
+    enum FuelType {
+      // Unspecified fuel type.
+      FUEL_TYPE_UNSPECIFIED = 0;
+
+      // Diesel fuel.
+      DIESEL = 1;
+
+      // Regular unleaded.
+      REGULAR_UNLEADED = 2;
+
+      // Midgrade.
+      MIDGRADE = 3;
+
+      // Premium.
+      PREMIUM = 4;
+
+      // SP 91.
+      SP91 = 5;
+
+      // SP 91 E10.
+      SP91_E10 = 6;
+
+      // SP 92.
+      SP92 = 7;
+
+      // SP 95.
+      SP95 = 8;
+
+      // SP95 E10.
+      SP95_E10 = 9;
+
+      // SP 98.
+      SP98 = 10;
+
+      // SP 99.
+      SP99 = 11;
+
+      // SP 100.
+      SP100 = 12;
+
+      // LPG.
+      LPG = 13;
+
+      // E 80.
+      E80 = 14;
+
+      // E 85.
+      E85 = 15;
+
+      // Methane.
+      METHANE = 16;
+
+      // Bio-diesel.
+      BIO_DIESEL = 17;
+
+      // Truck diesel.
+      TRUCK_DIESEL = 18;
+    }
+
+    // The type of fuel.
+    FuelType type = 1;
+
+    // The price of the fuel.
+    google.type.Money price = 2;
+
+    // The time the fuel price was last updated.
+    google.protobuf.Timestamp update_time = 3;
+  }
+
+  // The last known fuel price for each type of fuel this station has. There is
+  // one entry per fuel type this station has. Order is not important.
+  repeated FuelPrice fuel_prices = 1;
+}

package/build/protos/google/maps/places/v1/geometry.proto

@@ -32,11 +32,11 @@ option php_namespace = "Google\\Maps\\Places\\V1";
 message Circle {
   // Required. Center latitude and longitude.
   //
-  // The range of latitude must be within `[-90.0, 90.0]`. The range of the
-  // longitude must be within `[-180.0, 180.0]`.
+  // The range of latitude must be within [-90.0, 90.0]. The range of the
+  // longitude must be within [-180.0, 180.0].
   google.type.LatLng center = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Radius measured in meters. The radius must be within `[0.0,
-  // 50000.0]`.
+  // Required. Radius measured in meters. The radius must be within [0.0,
+  // 50000.0].
   double radius = 2 [(google.api.field_behavior) = REQUIRED];
 }

package/build/protos/google/maps/places/v1/photo.proto

@@ -0,0 +1,55 @@
+// Copyright 2023 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.
+
+syntax = "proto3";
+
+package google.maps.places.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/maps/places/v1/attribution.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Places.V1";
+option go_package = "cloud.google.com/go/maps/places/apiv1/placespb;placespb";
+option java_multiple_files = true;
+option java_outer_classname = "PhotoProto";
+option java_package = "com.google.maps.places.v1";
+option objc_class_prefix = "GMPSV1";
+option php_namespace = "Google\\Maps\\Places\\V1";
+
+// Information about a photo of a place.
+message Photo {
+  option (google.api.resource) = {
+    type: "places.googleapis.com/Photo"
+    pattern: "places/{place}/photos/{photo}"
+    plural: "photos"
+    singular: "photo"
+  };
+
+  // Output only. A reference representing this place photo which may be used to
+  // look up this place photo again (a.k.a. the API "resource" name:
+  // places/{place_id}/photos/{photo}).
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The maximum available width, in pixels.
+  int32 width_px = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The maximum available height, in pixels.
+  int32 height_px = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. This photo's authors.
+  repeated AuthorAttribution author_attributions = 4
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}