What can you do with it?

Google Maps allows you to access comprehensive location services programmatically. You can convert addresses to coordinates (geocoding), search for places by name or type, get detailed information about specific locations, calculate distances and travel times between multiple points, obtain elevation data, and get turn-by-turn directions. This integration is perfect for location-based applications, travel planning, and geographic data analysis.

How to use it?

Basic Command Structure

/your-Google-Maps-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The operation to perform with Google Maps

Tools

Geocode Address

Convert an address to geographic coordinates

Parameters:

  • address (required) - The address to geocode

Example:

/your-Google-Maps-connection
action: geocode
address: 1600 Amphitheatre Parkway, Mountain View, CA

Response:

{
  "results": [
    {
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "formatted_address": "1600 Amphitheatre Parkway, Mountain View, CA 94043, USA",
      "geometry": {
        "location": {
          "lat": 37.4224764,
          "lng": -122.0842499
        }
      }
    }
  ]
}

Search Places

Search for places by text query within a specified area

Parameters:

  • query (required) - What you’re searching for (e.g., “restaurants”, “hotels”)
  • location (required) - Geographic coordinates as “latitude,longitude”
  • radius (required) - Search radius in meters

Example:

/your-Google-Maps-connection
action: search-places
query: restaurants
location: 37.7749,-122.4194
radius: 1000

Response:

{
  "results": [
    {
      "name": "Restaurant Name",
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "formatted_address": "123 Main St, San Francisco, CA 94105",
      "geometry": {
        "location": {
          "lat": 37.7749,
          "lng": -122.4194
        }
      },
      "rating": 4.5,
      "types": ["restaurant", "food"]
    }
  ]
}

Get Place Details

Get detailed information about a specific place

Parameters:

  • place-id (required) - The unique identifier for a place

Example:

/your-Google-Maps-connection
action: place-details
place-id: ChIJN1t_tDeuEmsRUsoyG83frY4

Response:

{
  "result": {
    "name": "Business Name",
    "formatted_address": "123 Main St, Anytown, CA 12345",
    "formatted_phone_number": "(555) 123-4567",
    "website": "https://www.example.com",
    "rating": 4.5,
    "reviews": [
      {
        "author_name": "Reviewer Name",
        "rating": 5,
        "text": "Great place!"
      }
    ],
    "opening_hours": {
      "weekday_text": [
        "Monday: 9:00 AM – 8:00 PM"
      ],
      "open_now": true
    }
  }
}

Calculate Distance

Calculate distance and travel time between origins and destinations

Parameters:

  • origins (required) - Starting points (pipe-separated for multiple)
  • destinations (required) - Ending points (pipe-separated for multiple)
  • mode (required) - Travel mode: driving, walking, bicycling, or transit

Example:

/your-Google-Maps-connection
action: distance-matrix
origins: Seattle
destinations: San Francisco
mode: driving

Response:

{
  "origin_addresses": ["Seattle, WA, USA"],
  "destination_addresses": ["San Francisco, CA, USA"],
  "rows": [
    {
      "elements": [
        {
          "duration": {
            "text": "12 hours 46 mins",
            "value": 45987
          },
          "distance": {
            "text": "808 mi",
            "value": 1299738
          }
        }
      ]
    }
  ]
}

Get Directions

Get turn-by-turn directions between locations

Parameters:

  • origin (required) - Starting point as address or coordinates
  • destination (required) - Ending point as address or coordinates
  • mode (required) - Travel mode: driving, walking, bicycling, or transit

Example:

/your-Google-Maps-connection
action: directions
origin: Seattle
destination: San Francisco
mode: driving

Response:

{
  "routes": [
    {
      "summary": "I-5 N",
      "legs": [
        {
          "distance": {
            "text": "808 mi"
          },
          "duration": {
            "text": "12 hours 46 mins"
          },
          "steps": [
            {
              "html_instructions": "Head northwest on Madison St toward 3rd Ave",
              "distance": {
                "text": "0.1 mi"
              },
              "travel_mode": "DRIVING"
            }
          ]
        }
      ]
    }
  ]
}

Get Elevation

Get elevation data for specific locations

Parameters:

  • locations (required) - Pipe-separated list of lat,lng coordinates

Example:

/your-Google-Maps-connection
action: elevation
locations: 37.7749,-122.4194|36.7783,-119.4179

Response:

{
  "results": [
    {
      "elevation": 1608.637939453125,
      "location": {
        "lat": 37.7749,
        "lng": -122.4194
      },
      "resolution": 4.771975994110107
    }
  ]
}

Notes

All user-provided inputs are automatically encoded to prevent errors. For multiple origins or destinations, separate them with pipe characters (|). Coordinates should be provided in decimal degrees format (latitude,longitude). Travel modes include driving, walking, bicycling, and transit. Place IDs obtained from search results can be used to get detailed information about specific locations.