> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roe-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps Insights

> Extracts location information, nearby places, and geographic data from Google Maps.

## Google Maps Insights Engine Overview

The Google Maps Insights Engine extracts comprehensive location information from Google Maps, including address details, coordinates, nearby businesses, and street view data.

## Engine Inputs

The Google Maps Insights Engine Configuration has the following parameters:

* **address**: *required.* The address or location to search for on Google Maps.
* **instruction**: *required.* Instructions describing what information to extract about the location.
* **output\_schema**: *required.* JSON schema defining the structure of the output. Follows the standard [JSON schema specification](https://json-schema.org/).
* **model**: *optional.* The AI model to use (default: `gpt-4.1-2025-04-14`).
* **near\_by\_business\_types**: *optional.* Comma-separated list of business types to search for nearby (e.g., "restaurant,cafe,bank"). Leave empty to search all types.
* **near\_by\_radius**: *optional.* Radius in meters to search for nearby places (default: 15.0, max: 1000.0).
* **near\_by\_number**: *optional.* Maximum number of nearby places to return (default: 5).
* **include\_street\_view**: *optional.* Whether to include street view imagery (default: False).

See [Template Strings](/agents/input-definition#template-strings) for dynamic parameter configuration.

## Engine Output

The output will be a JSON value matching the structure specified in the **output\_schema**, typically including:

* Location name and formatted address
* Geographic coordinates (latitude/longitude)
* Nearby places and businesses
* Place details and ratings
* Street view imagery (if enabled)

## Example Usage

<Steps>
  <Step title="Create an Agent">
    Click on the "Add Agent" button in the top right corner of the Agents page.

    <Frame>
      <img src="https://mintcdn.com/roeai/qeWYCF2quzHQHhsD/images/add-agent.png?fit=max&auto=format&n=qeWYCF2quzHQHhsD&q=85&s=b3e1ec9b816ed1e57cb1ecfa53ff4288" width="1920" height="1045" data-path="images/add-agent.png" />
    </Frame>

    Enter a name and an optional description of your Agent.
  </Step>

  <Step title="Select the Google Maps Insights Engine" />

  <Step title="Configure the engine">
    <Info>\$ starts a template string</Info>

    * **address**: \$address
    * **instruction**: \$instruction
    * **model**: gpt-4.1-2025-04-14
    * **near\_by\_radius**: 15.0
    * **near\_by\_number**: 5
    * **include\_street\_view**: False
    * **output\_schema**: Copy and paste the JSON schema below:

    ```json theme={null}
    {
      "type": "object",
      "properties": {
        "location_name": {
          "type": "string",
          "description": "Name of the location"
        },
        "address": {
          "type": "string",
          "description": "Full address"
        },
        "coordinates": {
          "type": "object",
          "properties": {
            "latitude": { "type": "number" },
            "longitude": { "type": "number" }
          },
          "description": "Geographic coordinates"
        },
        "nearby_places": {
          "type": "array",
          "items": { "type": "string" },
          "description": "List of nearby places"
        },
        "summary": {
          "type": "string",
          "description": "Summary of the location"
        }
      },
      "required": ["location_name", "address"]
    }
    ```
  </Step>

  <Step title="Create the Agent">
    Hit the **Create** button.
  </Step>

  <Step title="Run a job">
    Create a new job and provide:

    * **address**: "1600 Amphitheatre Parkway, Mountain View, CA"
    * **instruction**: "Extract the location name, full address, coordinates, and list any notable nearby places"
  </Step>
</Steps>

## Use Cases

* **Location verification**: Verify business addresses and get coordinates
* **Competitive analysis**: Find nearby competitors and businesses
* **Site assessment**: Evaluate locations for real estate or business purposes
* **Geographic enrichment**: Add location data to customer or business records