feat: [google-maps-fleetengine-delivery] A new field past_locations is added to message .maps.fleetengine.delivery.v1.DeliveryVehicle (#13564)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE
feat: A new field `past_locations` is added to message
`.maps.fleetengine.delivery.v1.DeliveryVehicle`
docs: Updated documentation for field `task` in message
`.maps.fleetengine.delivery.v1.CreateTaskRequest` to clarify certain
fields can be optionally set.
END_COMMIT_OVERRIDE


PiperOrigin-RevId: 731478697

Source-Link:
googleapis/googleapis@cdb9d3b

Source-Link:
googleapis/googleapis-gen@f22d67a
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLW1hcHMtZmxlZXRlbmdpbmUtZGVsaXZlcnkvLk93bEJvdC55YW1sIiwiaCI6ImYyMmQ2N2EyNGY1ZjdkNTZjM2QwODljYTc5NzI3YzNiYTRlYWIwNmYifQ==

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-maps-fleetengine-delivery/README.rst

@@ -26,12 +26,12 @@ In order to use this library, you first need to go through the following steps:
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
 3. `Enable the Last Mile Fleet Solution Delivery API.`_
-4. `Setup Authentication.`_
+4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
 .. _Enable the Last Mile Fleet Solution Delivery API.:  https://developers.google.com/maps/documentation/transportation-logistics/mobility
-.. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
+.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
 ~~~~~~~~~~~~

packages/google-maps-fleetengine-delivery/google/maps/fleetengine_delivery/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.2.8"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-maps-fleetengine-delivery/google/maps/fleetengine_delivery_v1/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.2.8"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-maps-fleetengine-delivery/google/maps/fleetengine_delivery_v1/services/delivery_service/async_client.py

@@ -910,6 +910,12 @@ async def sample_create_task():
                    tasks)
                 -  ``task_duration``
 
+                The following fields can be optionally set:
+
+                -  ``target_time_window``
+                -  ``task_tracking_view_config``
+                -  ``attributes``
+
                 Note: The Task's ``name`` field is ignored. All other
                 Task fields must not be set; otherwise, an error is
                 returned.

packages/google-maps-fleetengine-delivery/google/maps/fleetengine_delivery_v1/services/delivery_service/client.py

@@ -1345,6 +1345,12 @@ def sample_create_task():
                    tasks)
                 -  ``task_duration``
 
+                The following fields can be optionally set:
+
+                -  ``target_time_window``
+                -  ``task_tracking_view_config``
+                -  ``attributes``
+
                 Note: The Task's ``name`` field is ignored. All other
                 Task fields must not be set; otherwise, an error is
                 returned.

packages/google-maps-fleetengine-delivery/google/maps/fleetengine_delivery_v1/types/delivery_api.py

@@ -376,6 +376,12 @@ class CreateTaskRequest(proto.Message):
             -  ``planned_location`` (optional for ``UNAVAILABLE`` tasks)
             -  ``task_duration``
 
+            The following fields can be optionally set:
+
+            -  ``target_time_window``
+            -  ``task_tracking_view_config``
+            -  ``attributes``
+
             Note: The Task's ``name`` field is ignored. All other Task
             fields must not be set; otherwise, an error is returned.
     """

packages/google-maps-fleetengine-delivery/google/maps/fleetengine_delivery_v1/types/delivery_vehicles.py

@@ -54,6 +54,13 @@ class DeliveryVehicle(proto.Message):
         last_location (google.maps.fleetengine_delivery_v1.types.DeliveryVehicleLocation):
             The last reported location of the Delivery
             Vehicle.
+        past_locations (MutableSequence[google.maps.fleetengine_delivery_v1.types.DeliveryVehicleLocation]):
+            Input only. Locations where this Delivery Vehicle has been
+            in the past that haven't yet been reported to Fleet Engine.
+            This is used in ``UpdateDeliveryVehicleRequest`` to record
+            locations which were previously unable to be sent to the
+            server. Typically this happens when the Delivery Vehicle
+            does not have internet connectivity.
         navigation_status (google.maps.fleetengine_delivery_v1.types.DeliveryVehicleNavigationStatus):
             The Delivery Vehicle's navigation status.
         current_route_segment (bytes):
@@ -185,6 +192,13 @@ class DeliveryVehicleType(proto.Enum):
         number=2,
         message=common.DeliveryVehicleLocation,
     )
+    past_locations: MutableSequence[
+        common.DeliveryVehicleLocation
+    ] = proto.RepeatedField(
+        proto.MESSAGE,
+        number=12,
+        message=common.DeliveryVehicleLocation,
+    )
     navigation_status: common.DeliveryVehicleNavigationStatus = proto.Field(
         proto.ENUM,
         number=3,

packages/google-maps-fleetengine-delivery/noxfile.py

@@ -382,20 +382,29 @@ def docfx(session):
     ["python", "upb", "cpp"],
 )
 def prerelease_deps(session, protobuf_implementation):
-    """Run all tests with prerelease versions of dependencies installed."""
+    """
+    Run all tests with pre-release versions of dependencies installed
+    rather than the standard non pre-release versions.
+    Pre-releases versions can be installed using
+    `pip install --pre <package>`.
+    """
 
     if protobuf_implementation == "cpp" and session.python in ("3.11", "3.12", "3.13"):
         session.skip("cpp implementation is not supported in python 3.11+")
 
     # Install all dependencies
-    session.install("-e", ".[all, tests, tracing]")
+    session.install("-e", ".")
+
     unit_deps_all = UNIT_TEST_STANDARD_DEPENDENCIES + UNIT_TEST_EXTERNAL_DEPENDENCIES
+    # Install dependencies for the unit test environment
     session.install(*unit_deps_all)
+
     system_deps_all = (
         SYSTEM_TEST_STANDARD_DEPENDENCIES
         + SYSTEM_TEST_EXTERNAL_DEPENDENCIES
         + SYSTEM_TEST_EXTRAS
     )
+    # Install dependencies for the system test environment
     session.install(*system_deps_all)
 
     # Because we test minimum dependency versions on the minimum Python
@@ -417,6 +426,7 @@ def prerelease_deps(session, protobuf_implementation):
         )
     ]
 
+    # Install dependencies specified in `testing/constraints-X.txt`.
     session.install(*constraints_deps)
 
     prerel_deps = [
@@ -458,3 +468,70 @@ def prerelease_deps(session, protobuf_implementation):
             "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
         },
     )
+
+
+@nox.session(python="3.13")
+@nox.parametrize(
+    "protobuf_implementation",
+    ["python", "upb"],
+)
+def core_deps_from_source(session, protobuf_implementation):
+    """Run all tests with local versions of core dependencies installed,
+    rather than pulling core dependencies from PyPI.
+    """
+
+    # Install all dependencies
+    session.install(".")
+
+    # Install dependencies for the unit test environment
+    unit_deps_all = UNIT_TEST_STANDARD_DEPENDENCIES + UNIT_TEST_EXTERNAL_DEPENDENCIES
+    session.install(*unit_deps_all)
+
+    # Install dependencies for the system test environment
+    system_deps_all = (
+        SYSTEM_TEST_STANDARD_DEPENDENCIES
+        + SYSTEM_TEST_EXTERNAL_DEPENDENCIES
+        + SYSTEM_TEST_EXTRAS
+    )
+    session.install(*system_deps_all)
+
+    # Because we test minimum dependency versions on the minimum Python
+    # version, the first version we test with in the unit tests sessions has a
+    # constraints file containing all dependencies and extras that should be installed.
+    with open(
+        CURRENT_DIRECTORY
+        / "testing"
+        / f"constraints-{UNIT_TEST_PYTHON_VERSIONS[0]}.txt",
+        encoding="utf-8",
+    ) as constraints_file:
+        constraints_text = constraints_file.read()
+
+    # Ignore leading whitespace and comment lines.
+    constraints_deps = [
+        match.group(1)
+        for match in re.finditer(
+            r"^\s*(\S+)(?===\S+)", constraints_text, flags=re.MULTILINE
+        )
+    ]
+
+    # Install dependencies specified in `testing/constraints-X.txt`.
+    session.install(*constraints_deps)
+
+    core_dependencies_from_source = [
+        "google-api-core @ git+https://github.com/googleapis/python-api-core.git",
+        "google-auth @ git+https://github.com/googleapis/google-auth-library-python.git",
+        f"{CURRENT_DIRECTORY}/../googleapis-common-protos",
+        f"{CURRENT_DIRECTORY}/../grpc-google-iam-v1",
+        "proto-plus @ git+https://github.com/googleapis/proto-plus-python.git",
+    ]
+
+    for dep in core_dependencies_from_source:
+        session.install(dep, "--ignore-installed", "--no-deps")
+
+    session.run(
+        "py.test",
+        "tests/unit",
+        env={
+            "PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION": protobuf_implementation,
+        },
+    )

packages/google-maps-fleetengine-delivery/samples/generated_samples/snippet_metadata_maps.fleetengine.delivery.v1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-maps-fleetengine-delivery",
-    "version": "0.2.8"
+    "version": "0.1.0"
   },
   "snippets": [
     {

packages/google-maps-fleetengine-delivery/tests/unit/gapic/fleetengine_delivery_v1/test_delivery_service.py

@@ -7752,6 +7752,7 @@ def test_create_delivery_vehicle_rest_call_success(request_type):
             "supplemental_location_accuracy": {},
             "road_snapped": True,
         },
+        "past_locations": {},
         "navigation_status": 1,
         "current_route_segment": b"current_route_segment_blob",
         "current_route_segment_end_point": {},
@@ -8167,6 +8168,7 @@ def test_update_delivery_vehicle_rest_call_success(request_type):
             "supplemental_location_accuracy": {},
             "road_snapped": True,
         },
+        "past_locations": {},
         "navigation_status": 1,
         "current_route_segment": b"current_route_segment_blob",
         "current_route_segment_end_point": {},