Registry /
maps / google-maps-routeoptimization
Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
RouteOptimizationClient
✓ from google.maps import routeoptimization_v1
✗ from google.cloud import routeoptimization_v1
Package lives under google.maps, not google.cloud.
Initialize client and call optimize_tours with a minimal model.
from google.maps import routeoptimization_v1
client = routeoptimization_v1.RouteOptimizationClient()
parent = "projects/" + (os.environ.get("GOOGLE_CLOUD_PROJECT", ""))
request = routeoptimization_v1.OptimizeToursRequest(
parent=parent,
model={
"vehicles": [
{
"start_location": {"latitude": 37.7749, "longitude": -122.4194},
"end_location": {"latitude": 37.7849, "longitude": -122.4094},
}
],
"shipments": [
{
"pickups": [{"arrival_location": {"latitude": 37.7749, "longitude": -122.4194}}],
"deliveries": [{"arrival_location": {"latitude": 37.7849, "longitude": -122.4094}}],
}
],
},
)
response = client.optimize_tours(request)
print(response)
Errors
Common errors & fixes
ImportError: cannot import name 'RouteOptimizationClient' from 'google.cloud'
Incorrect import path; the package is under google.maps, not google.cloud.
fixUse: from google.maps import routeoptimization_v1; client = routeoptimization_v1.RouteOptimizationClient()
ModuleNotFoundError: No module named 'google.maps.routeoptimization'
The package name has no hyphen when imported; also typo of 'routeoptimization' vs 'routeoptimization_v1'.
fixInstall with pip install google-maps-routeoptimization, then import as from google.maps import routeoptimization_v1
TypeError: optimize_tours() missing 1 required positional argument: 'request'
Calling method incorrectly; the new API requires an OptimizeToursRequest object.
fixCreate a request object: request = routeoptimization_v1.OptimizeToursRequest(parent=..., model=...); client.optimize_tours(request=request)
google.api_core.exceptions.InvalidArgument: 400 The parent resource name is invalid.
The 'parent' parameter does not include a location (e.g., '/locations/global').
fixSet parent to something like 'projects/my-project/locations/global'.
Upgrade
Version history
0.5.0latest on PyPI · released Jun 3, 2026
Audit
Dependencies
google-api-corerequiredRequired by Google Cloud client libraries for transport and error handling.
google-authrequiredHandles authentication (service account, ADC).
proto-plusrequiredProtobuf message handling.