Research with Google Maps

Search and analyze location-based business information using Google Maps data. This tool provides insights about businesses, competitors, and market presence in specific geographic areas.

This tool is part of our beta Tools API. Contact sales to request increased limits (available to select partners).

POST/v1/tools/research-with-google-maps

Endpoint

This endpoint uses Google Maps to research businesses, analyze local competition, and gather location-based insights.

Required parameters

Name
question
Type
string
Description
The research question to answer using Google Maps data. Be specific about location and what you're looking for.

Optional parameters

Name
output_schema
Type
object
Description
Define the structure of the output you want to receive.

Request

POST

/v1/tools/research-with-google-maps

curl -X POST https://api.utopianlabs.ai/v1/tools/research-with-google-maps \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What coffee shops are near the Salesforce Tower in San Francisco and what are their ratings?"
  }'

Response

{
  "output": "Near Salesforce Tower in San Francisco, there are several highly-rated coffee shops: 1) Blue Bottle Coffee (4.3★) - Located at 1 Ferry Building, known for artisanal coffee and minimalist aesthetic. 2) Philz Coffee (4.5★) - At 201 Berry St, famous for personalized blends and Mint Mojito coffee. 3) Mazarine Coffee (4.4★) - 720 Market St, popular for specialty roasts and pastries. 4) Réveille Coffee Co. (4.2★) - Multiple locations nearby, offers locally roasted coffee and breakfast items. 5) The Coffee Bean & Tea Leaf (4.0★) - 100 Montgomery St, convenient chain option. Most shops are within a 5-10 minute walk from Salesforce Tower, with Blue Bottle and Philz being the most popular among tech workers in the area."
}

Structured Output Example

Get detailed location analysis in a structured format.

Request with schema

curl -X POST https://api.utopianlabs.ai/v1/tools/research-with-google-maps \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What coffee shops are near the Salesforce Tower in San Francisco and what are their ratings?",
    "output_schema": {
      "locations": [{
        "name": "string",
        "address": "string",
        "rating": "number",
        "distance": "string",
        "features": ["string"]
      }],
      "summary": {
        "total_found": "number",
        "avg_rating": "number",
        "closest": "string",
        "highest_rated": "string"
      }
    }
  }'

Structured response

{
  "output": {
    "locations": [
      {
        "name": "Blue Bottle Coffee",
        "address": "1 Ferry Building, San Francisco, CA",
        "rating": 4.3,
        "distance": "0.3 miles",
        "features": ["Artisanal coffee", "Pastries", "Indoor seating"]
      },
      {
        "name": "Philz Coffee",
        "address": "201 Berry St, San Francisco, CA",
        "rating": 4.5,
        "distance": "0.2 miles",
        "features": ["Custom blends", "Mint mojito coffee", "Outdoor seating"]
      },
      {
        "name": "Mazarine Coffee",
        "address": "720 Market St, San Francisco, CA",
        "rating": 4.4,
        "distance": "0.1 miles",
        "features": ["Specialty roasts", "Breakfast", "WiFi"]
      }
    ],
    "summary": {
      "total_found": 8,
      "avg_rating": 4.3,
      "closest": "Mazarine Coffee",
      "highest_rated": "Philz Coffee"
    }
  }
}