Recommended Events In Person In Map
recommended_events_in_person_in_mapFull Description
This is the default tool to use to search for in-person Meetup events.
Discover in-person Meetup events near a specific location and display them in a map view. Consider the conversation context to decide which parameter to pass, preserving user intent.
Use this tool when users want to find physical events they can attend in person or ask for a map view. Returns events happening at physical venues with address information and it's displayed on a map.
Use this for:
- Finding local events to attend physically ("tech meetups near me")
- Discovering community gatherings in a specific area ("running groups in Seattle")
- Meeting people face-to-face at events ("in-person networking events")
- Physical meetups by category ("outdoor activities", "fitness classes")
- Also use when the user explicitly asks for a map view.
Do NOT use this for:
- Online/virtual events (use recommended_events_online instead)
- Searching by keyword in title/description (not available yet)
- RSVP management or event attendance actions
Note: Do not repeat event details in the text response, the user can see them in the structured content.
Returns: Structured response with in-person events, pagination info, and component metadata
Parameters (0 required, 9 optional)
end_date_rangestringEnd datetime in ISO 8601 format. Example: '2025-01-20T23:59:59Z'
nullis_happening_nowbooleanFilter to events currently in progress
nullis_starting_soonbooleanFilter to events starting within the next hour
nulllatnumberLatitude coordinate. Uses user's current location if not provided. Example: 37.7749 for San Francisco
nulllonnumberLongitude coordinate. Uses user's current location if not provided. Example: -122.4194 for San Francisco
nullquerystringOptional search keywords (1-3 words) for narrow, specific topics. Use topic_category_id for broad categories (e.g., SOCIAL_ACTIVITIES, TECH, SPORTS). Use query only for specific topics within those categories. Examples: 'python' (not TECH), 'basketball' (not SPORTS), 'hiking', 'board games'. Avoid using this parameter for general event discovery. When provided, searches by keyword relevance instead of personalized recommendations.
nullradiusnumberSearch radius in miles from coordinates. Use it to limit the results to a specific area.
nullstart_date_rangestringStart datetime in ISO 8601 format. Example: '2025-01-15T00:00:00Z'
nulltopic_category_idCategory for narrower interest-based filtering. Available categories: ART_AND_CULTURE, CAREER_AND_BUSINESS, COMMUNITY_AND_ENVIRONMENT, DANCING, GAMES, HEALTH_AND_WELLBEING, HOBBIES_AND_PASSIONS, IDENTITY_AND_LANGUAGE, MOVEMENTS_AND_POLITICS, MUSIC, PARENTS_AND_FAMILY, PETS_AND_ANIMALS, RELIGION_AND_SPIRITUALITY, SCIENCE_AND_EDUCATION, SOCIAL_ACTIVITIES, SPORT_AND_FITNESS, SUPPORT_AND_COACHING, TECH, TRAVEL_AND_OUTDOOR, WRITING
null