Search Google Maps for places based on a text query.

This tool searches for businesses, locations, and points of interest using Google Maps Places API. It returns detailed information including contact details, ratings, opening hours, and location data.

Args: query: Search query like "coffee in San Francisco" or "pizza restaurants in New York City". Can include location and business type. max_results: Number of results to return (1-20). Default is 10.

Returns: Dictionary containing query, total_results, and places list with detailed information including name, address, phone, website, rating, location, hours, and more.

Get detailed information about a specific place by its Google Place ID.

Use this to get more details about a place after finding it with search_places. Returns additional info like reviews, amenities, and editorial summaries.

Args: place_id: Google Place ID (e.g., "places/ChIJN1t_tDeuEmsRUsoyG83frY4")

Returns: Dictionary with detailed place information including: - Basic info: name, address, phone, website, rating - Reviews: Top 5 user reviews with ratings and text - Amenities: delivery, dine_in, takeout, outdoor_seating, etc. - Opening hours and business status

Search for places near specific coordinates.

Use this when you have GPS coordinates and want to find places nearby. Great for "find restaurants near me" type queries.

Args: latitude: Latitude of the center point (e.g., 42.4531) longitude: Longitude of the center point (e.g., 18.5375) radius_meters: Search radius in meters (default 1000, max 50000) place_type: Optional type filter like "restaurant", "cafe", "hotel", "gas_station", "pharmacy", "hospital", etc. max_results: Number of results to return (1-20). Default 10.

Returns: Dictionary with center point, radius, and list of nearby places.

Example: search_nearby(42.4531, 18.5375, radius_meters=500, place_type="cafe")

Get directions and route between two locations.

Returns step-by-step directions with distance and duration. Note: Requires Directions API to be enabled in Google Cloud.

Args: origin: Starting point - can be address or "lat,lng" coordinates destination: End point - can be address or "lat,lng" coordinates
mode: Travel mode - "driving" (default), "walking", "bicycling", or "transit"

Returns: Dictionary with route information including: - Total distance and duration - Step-by-step navigation instructions - Traffic duration (for driving) - Route warnings

Example: get_directions("Union Square, San Francisco", "Ferry Building, San Francisco", mode="walking")

Convert an address or place description to GPS coordinates.

Use this when a user describes their location (hotel name, landmark, street address) and you need coordinates for search_nearby.

Args: address: Address, place name, landmark, or location description. Examples: "Ferry Building San Francisco", "Eiffel Tower Paris", "Times Square New York"

Returns: Dictionary with: - formatted_address: The official address Google matched - latitude: Latitude coordinate - longitude: Longitude coordinate
- place_id: Google Place ID

Example: geocode("Ferry Building, San Francisco")

Convert GPS coordinates to a human-readable address.

Use this when you have coordinates and need to know the address.

Args: latitude: Latitude coordinate (e.g., 42.4531) longitude: Longitude coordinate (e.g., 18.5375)

Returns: Dictionary with formatted address and location details.

Example: reverse_geocode(42.4531, 18.5375)