# Local Business Discovery and Mapping ## Links - Product page URL: https://www.agentpmt.com/marketplace/local-business-discovery-and-mapping - Product markdown URL: https://www.agentpmt.com/marketplace/local-business-discovery-and-mapping?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/local-business-discovery-and-mapping?format=agent-json ## Overview - Product ID: 695e8470c309cf48479329e4 - Vendor: Apoth3osis - Type: data - Unit type: request - Price: 2000 credits - Categories: Mapping & Visualization, Geocoding & Location Services, Places & Business Search, Address Validation & Standardization - Generated at: 2026-04-15T18:34:52.339Z ### Page Description Comprehensive place discovery and geocoding service that enables AI agents to search, discover, and analyze physical locations in the real world. The tool provides powerful search capabilities with two primary modes: nearby search for radius-based discovery and text search for flexible keyword-based queries across global locations. The nearby search functionality supports advanced filtering through 30+ predefined category groups, intelligently organized into logical clusters such as restaurants_and_dining (covering 37 restaurant types from fast food to fine dining), health_and_medical (hospitals, doctors, pharmacies), entertainment_and_attractions (museums, theaters, amusement parks), and transportation (airports, train stations, transit stops). Each category group automatically expands to include all relevant place types, enabling precise filtering without manual specification of individual types. Core capabilities include discovering places within a 1-50km radius of any location, searching globally with text queries and optional location bias, forward geocoding to convert addresses into coordinates with place IDs and address components, reverse geocoding to transform coordinates into structured addresses, and intelligent category-based filtering with both inclusion and exclusion options. The tool returns rich place data including names, addresses, ratings, price levels, operating status, and precise coordinates. The tool automatically handles address-to-coordinate conversion when needed, allowing agents to specify search centers using either street addresses or lat/lng coordinates. All searches support configurable result limits up to 50 places per query, with detailed metadata for each discovered location. The integrated geocoding ensures seamless workflow between address-based and coordinate-based operations. ### Agent Description Search for nearby places or by text query. 30+ category filters. Forward/reverse geocoding. Up to 50 results with ratings, prices, coordinates. ## Details Tab ### Details Comprehensive place discovery and geocoding service that enables AI agents to search, discover, and analyze physical locations in the real world. The tool provides powerful search capabilities with two primary modes: nearby search for radius-based discovery and text search for flexible keyword-based queries across global locations. The nearby search functionality supports advanced filtering through 30+ predefined category groups, intelligently organized into logical clusters such as restaurants_and_dining (covering 37 restaurant types from fast food to fine dining), health_and_medical (hospitals, doctors, pharmacies), entertainment_and_attractions (museums, theaters, amusement parks), and transportation (airports, train stations, transit stops). Each category group automatically expands to include all relevant place types, enabling precise filtering without manual specification of individual types. Core capabilities include discovering places within a 1-50km radius of any location, searching globally with text queries and optional location bias, forward geocoding to convert addresses into coordinates with place IDs and address components, reverse geocoding to transform coordinates into structured addresses, and intelligent category-based filtering with both inclusion and exclusion options. The tool returns rich place data including names, addresses, ratings, price levels, operating status, and precise coordinates. The tool automatically handles address-to-coordinate conversion when needed, allowing agents to specify search centers using either street addresses or lat/lng coordinates. All searches support configurable result limits up to 50 places per query, with detailed metadata for each discovered location. The integrated geocoding ensures seamless workflow between address-based and coordinate-based operations. ### Actions - `nearby_search` (20 credits): Search for places near a location by category. Requires either an address or latitude/longitude coordinates. Automatically geocodes addresses to coordinates. - `text_search` (20 credits): Search for places using a free-text query. Optionally bias results toward a specific location. - `geocode` (20 credits): Convert a street address or place name into geographic coordinates, place ID, and address components. - `reverse_geocode` (20 credits): Convert latitude/longitude coordinates into a human-readable address with place ID and address components. ### Use Cases Local business discovery and recommendations for travel planning, Restaurant and dining venue search for meal planning applications, Healthcare facility location for medical service directories, Retail store finding for shopping assistance, Hotel and accommodation search for booking systems, Emergency service location finding for safety applications, Transportation hub discovery for route planning, Educational institution search for school finders, Entertainment venue discovery for event planning, Park and recreation area finding for outdoor activities, Professional service provider location for business directories, Real estate area analysis with nearby amenities, Market research for competitor analysis and site selection, Delivery service area validation and address verification, Tourism point of interest discovery for travel guides ### Workflows Using This Tool No public workflows currently reference this product. ### Related Content No related content is currently linked to this product. ## Advanced Tab ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to `https://api.agentpmt.com/mcp`. All tool execution happens in the cloud and the server cannot edit any files on your computer. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "695e8470c309cf48479329e4", "parameters": { "action": "nearby_search", "radius_meters": 1000, "max_results": 50 } }' ``` ### Autonomous Agents Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead. - External Agent API page URL: https://www.agentpmt.com/external-agent-api - External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md ### Schema #### Parameters - Schema type: actions ```json { "actions": { "nearby_search": { "description": "Search for places near a location by category. Requires either an address or latitude/longitude coordinates. Automatically geocodes addresses to coordinates.", "properties": { "address": { "type": "string", "description": "Street address or area name to search near. Will be geocoded to coordinates automatically. Required if latitude/longitude are not provided.", "required": false }, "latitude": { "type": "number", "description": "Latitude coordinate of search center (-90 to 90). Required if address is not provided.", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate of search center (-180 to 180). Required if address is not provided.", "required": false, "minimum": -180, "maximum": 180 }, "included_types": { "type": "array", "description": "Place category groups to include in search results. Each group expands to multiple specific place types.", "required": false, "items": { "type": "string", "enum": [ "restaurants_and_dining", "cafes_and_light_fare", "bars_and_nightlife", "bakeries_and_sweets", "food_retail_and_markets", "food_services", "lodging_and_accommodation", "shopping_general", "shopping_specialty_retail", "automotive", "health_and_medical", "beauty_and_personal_care", "fitness_and_sports", "parks_and_nature", "entertainment_and_attractions", "arts_and_culture", "performing_arts_and_venues", "religious_sites", "education", "government_and_civic", "financial_services", "professional_services", "home_services_and_contractors", "transportation", "travel_and_tourism", "residential", "geographic_administrative", "outdoor_recreation", "community_and_social", "miscellaneous_services" ] } }, "excluded_types": { "type": "array", "description": "Place category groups to exclude from search results.", "required": false, "items": { "type": "string", "enum": [ "restaurants_and_dining", "cafes_and_light_fare", "bars_and_nightlife", "bakeries_and_sweets", "food_retail_and_markets", "food_services", "lodging_and_accommodation", "shopping_general", "shopping_specialty_retail", "automotive", "health_and_medical", "beauty_and_personal_care", "fitness_and_sports", "parks_and_nature", "entertainment_and_attractions", "arts_and_culture", "performing_arts_and_venues", "religious_sites", "education", "government_and_civic", "financial_services", "professional_services", "home_services_and_contractors", "transportation", "travel_and_tourism", "residential", "geographic_administrative", "outdoor_recreation", "community_and_social", "miscellaneous_services" ] } }, "radius_meters": { "type": "integer", "description": "Search radius in meters around the center point.", "required": false, "default": 1000, "minimum": 1, "maximum": 50000 }, "max_results": { "type": "integer", "description": "Maximum number of results to return.", "required": false, "default": 50, "minimum": 1, "maximum": 50 } } }, "text_search": { "description": "Search for places using a free-text query. Optionally bias results toward a specific location.", "properties": { "query": { "type": "string", "description": "Text search query (e.g., 'best pizza in Brooklyn', 'Statue of Liberty').", "required": true }, "address": { "type": "string", "description": "Bias results toward this address. Optional location context.", "required": false }, "latitude": { "type": "number", "description": "Latitude to bias results toward (-90 to 90).", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude to bias results toward (-180 to 180).", "required": false, "minimum": -180, "maximum": 180 }, "radius_meters": { "type": "integer", "description": "Bias radius in meters around the location.", "required": false, "default": 1000, "minimum": 1, "maximum": 50000 }, "max_results": { "type": "integer", "description": "Maximum number of results to return.", "required": false, "default": 50, "minimum": 1, "maximum": 50 } } }, "geocode": { "description": "Convert a street address or place name into geographic coordinates, place ID, and address components.", "properties": { "address": { "type": "string", "description": "The street address or place name to geocode.", "required": true } } }, "reverse_geocode": { "description": "Convert latitude/longitude coordinates into a human-readable address with place ID and address components.", "properties": { "latitude": { "type": "number", "description": "Latitude coordinate (-90 to 90).", "required": true, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate (-180 to 180).", "required": true, "minimum": -180, "maximum": 180 } } } }, "properties": { "action": { "type": "string", "description": "Use 'get_instructions' to retrieve documentation. Action to perform.", "required": true, "enum": [ "get_instructions", "nearby_search", "text_search", "geocode", "reverse_geocode" ] }, "address": { "type": "string", "description": "Street address or area name for geocoding or search center.", "required": false }, "latitude": { "type": "number", "description": "Latitude coordinate (-90 to 90).", "required": false, "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "description": "Longitude coordinate (-180 to 180).", "required": false, "minimum": -180, "maximum": 180 }, "radius_meters": { "type": "integer", "description": "Search radius in meters for nearby_search and text_search location bias.", "required": false, "default": 1000, "minimum": 1, "maximum": 50000 }, "query": { "type": "string", "description": "Text query for text_search action.", "required": false }, "included_types": { "type": "array", "description": "Place category groups to include in nearby_search.", "required": false, "items": { "type": "string", "enum": [ "restaurants_and_dining", "cafes_and_light_fare", "bars_and_nightlife", "bakeries_and_sweets", "food_retail_and_markets", "food_services", "lodging_and_accommodation", "shopping_general", "shopping_specialty_retail", "automotive", "health_and_medical", "beauty_and_personal_care", "fitness_and_sports", "parks_and_nature", "entertainment_and_attractions", "arts_and_culture", "performing_arts_and_venues", "religious_sites", "education", "government_and_civic", "financial_services", "professional_services", "home_services_and_contractors", "transportation", "travel_and_tourism", "residential", "geographic_administrative", "outdoor_recreation", "community_and_social", "miscellaneous_services" ] } }, "excluded_types": { "type": "array", "description": "Place category groups to exclude in nearby_search.", "required": false, "items": { "type": "string", "enum": [ "restaurants_and_dining", "cafes_and_light_fare", "bars_and_nightlife", "bakeries_and_sweets", "food_retail_and_markets", "food_services", "lodging_and_accommodation", "shopping_general", "shopping_specialty_retail", "automotive", "health_and_medical", "beauty_and_personal_care", "fitness_and_sports", "parks_and_nature", "entertainment_and_attractions", "arts_and_culture", "performing_arts_and_venues", "religious_sites", "education", "government_and_civic", "financial_services", "professional_services", "home_services_and_contractors", "transportation", "travel_and_tourism", "residential", "geographic_administrative", "outdoor_recreation", "community_and_social", "miscellaneous_services" ] } }, "max_results": { "type": "integer", "description": "Maximum number of results (1-50).", "required": false, "default": 50, "minimum": 1, "maximum": 50 } } } ``` ### Usage Instructions # Local Business Discovery and Mapping Search for nearby businesses, find places by text query, and convert between addresses and coordinates using Google Maps. ## Actions ### nearby_search Search for places near a location by category. **Required:** At least one of `address` OR (`latitude` + `longitude`) **Optional:** - `included_types` (array) - Category groups to include (see Category Groups below) - `excluded_types` (array) - Category groups to exclude - `radius_meters` (integer, 1-50000, default: 1000) - Search radius in meters - `max_results` (integer, 1-50, default: 50) - Maximum results to return **Example - Find restaurants near an address:** ```json { "action": "nearby_search", "address": "Times Square, New York, NY", "included_types": ["restaurants_and_dining"], "radius_meters": 500, "max_results": 10 } ``` **Example - Find hotels near coordinates:** ```json { "action": "nearby_search", "latitude": 40.7580, "longitude": -73.9855, "included_types": ["lodging_and_accommodation"], "radius_meters": 2000 } ``` **Example - Find everything except restaurants:** ```json { "action": "nearby_search", "address": "Downtown Chicago, IL", "excluded_types": ["restaurants_and_dining", "cafes_and_light_fare"], "radius_meters": 1000 } ``` --- ### text_search Search for places using a free-text query. Optionally bias results toward a location. **Required:** - `query` (string) - The search text **Optional:** - `address` (string) - Bias results toward this address - `latitude` / `longitude` (number) - Bias results toward these coordinates - `radius_meters` (integer, 1-50000, default: 1000) - Bias radius in meters - `max_results` (integer, 1-50, default: 50) - Maximum results to return **Example - Search by query with location bias:** ```json { "action": "text_search", "query": "best pizza in Brooklyn", "address": "Brooklyn, NY", "radius_meters": 5000, "max_results": 10 } ``` **Example - Search without location bias:** ```json { "action": "text_search", "query": "Statue of Liberty" } ``` --- ### geocode Convert a street address or place name into geographic coordinates. **Required:** - `address` (string) - The address or place name to geocode **Example:** ```json { "action": "geocode", "address": "1600 Amphitheatre Parkway, Mountain View, CA" } ``` **Returns:** Formatted address, latitude/longitude, place ID, and address components. --- ### reverse_geocode Convert geographic coordinates into a human-readable address. **Required:** - `latitude` (number, -90 to 90) - `longitude` (number, -180 to 180) **Example:** ```json { "action": "reverse_geocode", "latitude": 37.4224764, "longitude": -122.0842499 } ``` **Returns:** Formatted address, place ID, and address components. --- ## Category Groups Use these values in `included_types` and `excluded_types` for `nearby_search`: | Category | What It Includes | |---|---| | restaurants_and_dining | Restaurants of all cuisines (Italian, Chinese, Mexican, etc.), fast food, fine dining, steakhouses | | cafes_and_light_fare | Coffee shops, tea houses, cafes, bagel/donut/juice shops | | bars_and_nightlife | Bars, pubs, wine bars, night clubs, karaoke | | bakeries_and_sweets | Bakeries, candy stores, ice cream shops, chocolate shops | | food_retail_and_markets | Grocery stores, supermarkets, delis, butcher shops, convenience stores | | food_services | Catering, food courts, food delivery, sandwich shops | | lodging_and_accommodation | Hotels, motels, hostels, B&Bs, resorts, inns | | shopping_general | Malls, department stores, discount stores, gift shops | | shopping_specialty_retail | Book stores, clothing, jewelry, electronics, pet stores, florists | | automotive | Car dealers, repair, rental, car wash, gas stations, EV charging | | health_and_medical | Hospitals, doctors, dentists, chiropractors, pharmacies | | beauty_and_personal_care | Salons, barber shops, spas, nail salons, wellness centers | | fitness_and_sports | Gyms, sports clubs, swimming pools, yoga studios, bowling alleys | | parks_and_nature | Parks, gardens, beaches, hiking areas, wildlife parks | | entertainment_and_attractions | Amusement parks, zoos, aquariums, movie theaters, casinos | | arts_and_culture | Museums, art galleries, cultural centers, historical landmarks | | performing_arts_and_venues | Theaters, concert halls, arenas, stadiums, event venues | | religious_sites | Churches, mosques, synagogues, temples | | education | Schools, universities, preschools, camps | | government_and_civic | City hall, courthouses, post offices, police/fire stations | | financial_services | Banks, ATMs, accounting firms, insurance agencies | | professional_services | Lawyers, consultants, real estate agencies | | home_services_and_contractors | Electricians, plumbers, locksmiths, hardware stores, moving companies | | transportation | Airports, train stations, bus stops, subway stations, ferry terminals | | travel_and_tourism | Travel agencies, tour operators, visitor centers | | residential | Apartment buildings, condos, housing complexes | | geographic_administrative | Countries, states, cities, postal codes | | outdoor_recreation | Campgrounds, RV parks, farms, ski resorts | | community_and_social | Community centers, libraries, public baths | | miscellaneous_services | Laundry, tailors, courier services, veterinary care | ## Common Workflows **Find and locate a business type:** 1. Use `nearby_search` with a category to find businesses near a location 2. Use `geocode` to get exact coordinates for any address from the results **Identify what is at a location:** 1. Use `reverse_geocode` with coordinates to get the address 2. Use `nearby_search` with those coordinates to discover surrounding businesses **Search and filter:** 1. Use `text_search` with a descriptive query for broad results 2. Use `nearby_search` with `included_types` for category-specific filtered results ## Important Notes - For `nearby_search`, you must provide either an `address` or both `latitude` and `longitude`. If you provide an address, it is automatically geocoded to coordinates. - For `text_search`, location parameters are optional and serve as a bias (not a strict boundary). - The `included_types` and `excluded_types` parameters only apply to `nearby_search`. They do not work with `text_search`. - Maximum search radius is 50,000 meters (50 km). - Maximum results per request is 50. ### About The Developer - Vendor name: Apoth3osis - Website: apoth3osis.io We build tools that enable AI agents to excel in the mathematical realm. Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation. ### Frequently Asked Questions No linked FAQs are currently available. ### Dependencies This product has no public dependency products.