Summary

This PR brings the google-maps-services-python library up to date with modern Google Maps Platform APIs.

It introduces native support for Isochrones API, Routes API (v2), Places API (New / v1), Solar API, Air Quality API, and Pollen API, along with core Client updates for response field masking (X-Goog-FieldMask), executable CUJ samples, automated GitHub Actions CI secrets integration, and a live server integration test suite.

🆕 New APIs and API Calls

1. Isochrones API — [googlemaps/isochrones.py](file:///googlemaps/isochrones.py)

• Client.generate_isochrones(location, travel_mode="DRIVE", travel_direction="FROM", duration_seconds=900, ...): Calculates reachable boundaries (isochrone polygons) within a time or distance threshold (POST https://isochrones.googleapis.com/v1/isochrones:generate).

2. Routes API (v2) — [googlemaps/routes.py](file:///googlemaps/routes.py)

• Client.compute_routes(origin, destination, fields=None, travel_mode=None): Modern directions API (POST https://routes.googleapis.com/directions/v2:computeRoutes).
• Client.compute_route_matrix(origins, destinations, fields=None, travel_mode=None, routing_preference=None): Modern distance matrix API (POST https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix).

3. Places API (New / v1) — [googlemaps/places_v1.py](file:///googlemaps/places_v1.py)

• Client.places_search_text(text_query, fields=None, ...): Modern text search (POST https://places.googleapis.com/v1/places:searchText).
• Client.places_search_nearby(location, radius, fields=None, ...): Modern nearby search (POST https://places.googleapis.com/v1/places:searchNearby).
• Client.place_v1(place_id, fields=None, ...): Modern place details (GET https://places.googleapis.com/v1/places/{place_id}).
• Client.places_autocomplete_v1(input_text, ...): Modern place autocomplete (POST https://places.googleapis.com/v1/places:autocomplete).
• Client.place_photo_v1(name, max_height_px=None, max_width_px=None, ...): Modern photo media endpoint (GET https://places.googleapis.com/v1/{name}/media).

4. Solar API — [googlemaps/solar.py](file:///googlemaps/solar.py)

• Client.find_closest_building_insights(location, required_quality=None, ...): Finds closest building insights (GET https://solar.googleapis.com/v1/buildingInsights:findClosest).
• Client.get_solar_data_layers(location, radius_meters, view=None, ...): Retrieves solar imagery/data layers (GET https://solar.googleapis.com/v1/dataLayers:get).

5. Air Quality API — [googlemaps/airquality.py](file:///googlemaps/airquality.py)

• Client.air_quality_current_conditions(location, ...): Air quality current conditions (POST https://airquality.googleapis.com/v1/currentConditions:lookup).

6. Pollen API — [googlemaps/pollen.py](file:///googlemaps/pollen.py)

• Client.pollen_forecast(location, days=1, ...): Pollen forecast search (GET https://pollen.googleapis.com/v1/forecast:lookup).

🌐 Live Server Integration Test Suite (tests/test_integration.py)

• Includes live integration tests that query actual Google Maps Platform production servers when an API key is provided ().
• Integrated into GitHub Actions CI (.github/workflows/test.yml) to automatically run live tests when secrets.GOOGLE_MAPS_API_KEY is present.
• Verifies:
  • Isochrones API: Live reachability polygon generation and GeoJSON MultiPolygon geometry resolution.
  • Places API (New): Text search for Devils Tower (asserting display name, address, and geographic location ~44.59° N, 104.71° W).
  • Geocoding & Reverse Geocoding: Address resolution for Googleplex coordinates (37.422, -122.084).
  • Routes API (v2): Turn-by-turn routing between San Francisco and San Jose.
  • Solar, Air Quality, & Pollen APIs: Environmental data lookup for Googleplex.
  • Elevation API: Peak elevation query for Mount Everest (> 8000m).
  • Address Validation API: Verdict verification.

💻 Executable CUJ Sample Suite (samples/)

• samples/isochrone_reachability_cuj.py: 15-Minute City & Emergency Coverage Analysis.
• samples/data_science_pandas_geocoding.py: Address processing & Pandas DataFrame pipeline export.
• samples/fleet_optimization_matrix.py: Vehicle Routing Matrix generation for OR-Tools/SciPy solvers.
• samples/infrastructure_elevation_snapping.py: Roads API GPS snapping & Elevation profile analysis.
• samples/real_estate_insights.py: Real Estate Property Evaluation & Environmental Analysis.
• samples/delivery_route_planner.py: Warehouse-to-delivery route planning.
• samples/travel_discovery_assistant.py: Places API (New) discovery & rich photo media experience.

⚠️ Breaking Changes

None. All legacy methods remain 100% backward compatible.

🧪 Testing

• Total Test Suite: 147 / 147 test targets passing (138 unit tests + 9 live integration tests).
• Code Statement Coverage: 90% across python library code.