Places

Places are real-world venues where meetings can happen. A restaurant for a lunch meeting, a cafe for a quick intro, a golf course for relationship-building, a gallery for a creative conversation. The right place sets the tone.

Overview

Use search_places to find venues near a lead. The tool searches across Google Maps and returns structured results with ratings, addresses, and coordinates. Places are the everyday alternative to events — always available, low friction, and adaptable to the context.

The Place type

1
interface Place {
2
  id: string;              // Unique identifier
3
  name: string;            // Venue name
4
  type: string;            // Place type (see below)
5
  address: string;         // Street address
6
  city: string;            // City
7
  lat: number;             // Latitude
8
  lng: number;             // Longitude
9
  rating?: number;         // Rating (1-5), available for restaurants via TripAdvisor
10
  tripadvisor_url?: string; // TripAdvisor page (restaurants only)
11
  tags: string[];          // Tags for context
12
}

Place types

search_places parameters

Example usage

1
import { search_places } from '@humanconnection/toolkit';
2
3
// Find restaurants near the lead for a lunch meeting
4
const restaurants = await search_places({
5
  location: { city: "San Francisco" },
6
  type: "restaurant",
7
  radius_km: 5,
8
  min_rating: 4
9
});
10
11
// Find a golf course for an executive meeting
12
const golf = await search_places({
13
  location: { city: "Scottsdale" },
14
  type: "golf",
15
  radius_km: 15
16
});
17
18
// Find a cafe for a quick intro
19
const cafes = await search_places({
20
  location: { lat: 37.7749, lng: -122.4194 },
21
  type: "cafe",
22
  radius_km: 2
23
});

Example response

1
{
2
  "data": [
3
    {
4
      "id": "plc_m4n5o6p7q8r9s0t1",
5
      "name": "Tartine Manufactory",
6
      "type": "restaurant",
7
      "address": "595 Alabama St, San Francisco, CA 94110",
8
      "city": "San Francisco",
9
      "lat": 37.7634,
10
      "lng": -122.4113,
11
      "rating": 4.5,
12
      "tripadvisor_url": "https://www.tripadvisor.com/...",
13
      "tags": ["bakery", "california", "brunch"]
14
    }
15
  ],
16
  "total": 1,
17
  "has_more": false
18
}

Places vs. Events

How places relate to other resources

• Meetings: Use a place’s address in the location field when calling send_meeting_invite.
• Events: Events are the preferred meeting context. Places are the always-available fallback.
• Humans: After finding someone with search_humans, search for places near their location.

Best practices

• Default to cafes for first meetings. Casual, accessible, low-commitment. A 20-minute coffee is easier to accept than a lunch.
• Use restaurants for high-LTV leads. Sharing a meal creates personal connection and extends conversation time. It signals investment.
• Try golf or tennis for executives. Activity-based meetings break the ice naturally and create memorable experiences.
• Use min_rating for restaurants. A 4+ TripAdvisor rating ensures a good experience. The venue reflects on your brand.
• Match place to context. A gallery for a creative lead. A cafe for a quick intro. A stadium for client entertainment. The place is part of the message.