Google Maps Tools

--- name: google-maps description: Search for places and businesses, get detailed location information with ratings and reviews, find nearby points of interest, and access business contact details including hours, phone numbers, and addresses. Use when users need to find restaurants, hotels, stores, get business information, check reviews and ratings, or discover local services. metadata: author: MCP360 version: "1.0.0" tags: - Maps - Local Search - Places - Business Directory - Reviews - Location Intelligence - Google Maps - POI keywords: - maps - google maps - places - business - local - reviews - restaurant - hotel - location - address - directions - nearby - gps - coordinates - ratings - hours - contact creditsPerUse: 1 isPremium: false --- # Google Maps Tools Professional Google Maps API for local business discovery, place intelligence, and location-based services. Find businesses, retrieve detailed place information with reviews and ratings, discover nearby points of interest, and access comprehensive business data for market research and local SEO. ## Core Capabilities - **Place Search**: Search for businesses and locations by name, category, or keywords with location bias, and returns place listings with names, addresses, ratings, business status, place IDs, and geographic coordinates for mapping - **Place Details**: Get comprehensive business information for specific locations including full address and contact information, and returns detailed data with phone numbers, websites, opening hours, price levels, photos, accessibility features, and amenity information - **Nearby Search**: Discover places within a radius of geographic coordinates or address, and returns proximity-sorted results with distance calculations, business types, and relevance scores for location-based recommendations - **Reviews and Ratings**: Access customer reviews, ratings, and sentiment data for businesses, and returns review text, star ratings, review dates, user profiles, helpful votes, and aggregate rating statistics for reputation analysis ## API Access ### MCP360 Connect Endpoints - **Base URL**: `https://connect.mcp360.ai/api/v1` - **Service Path**: `google-maps` - **Authentication**: Bearer token (API key required) ### Service Metadata Endpoint Retrieve service information and available tools: ```bash curl "https://connect.mcp360.ai/api/v1/google-maps" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Tool Execution Endpoint Execute specific tools by making POST requests: ```bash curl -X POST "https://connect.mcp360.ai/api/v1/google-maps/{tool_name}" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{...parameters...}' ``` ## Available Tools ### Search Places Find businesses, landmarks, and points of interest by name, category, or search query. **Tool Name:** `search_places` **Credits Required:** 1 **Parameters:** - `query` (string, required): Search terms like "pizza restaurants", "hotels near Times Square", or "Apple Store" - `location` (string, optional): Location bias like "New York, NY" or "San Francisco, CA" for regional results - `language` (string, optional): Language code for results like "en", "es", "fr" (Default: "en") - `region` (string, optional): Country code for regional bias like "us", "uk", "ca" **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/google-maps/search_places" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "italian restaurants", "location": "Manhattan, New York", "language": "en" }' ``` ### Get Place Details Retrieve comprehensive information about a specific place using its Google Place ID. **Tool Name:** `get_place_details` **Credits Required:** 1 **Parameters:** - `place_id` (string, required): Google Place ID like "ChIJN1t_tDeuEmsRUsoyG83frY4" obtained from search results - `language` (string, optional): Language for place information like "en", "es", "ja" (Default: "en") **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/google-maps/get_place_details" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "language": "en" }' ``` **Response Includes:** - Business name and address - Phone number and website - Opening hours and current status - Price level and rating - Reviews count and photos - Business type and amenities - Wheelchair accessibility - Payment methods accepted ### Search Nearby Find places near a specific location using coordinates or address with radius filtering. **Tool Name:** `search_nearby` **Credits Required:** 1 **Parameters:** - `latitude` (number, optional): Geographic latitude like 40.7580 for Times Square - `longitude` (number, optional): Geographic longitude like -73.9855 for Times Square - `address` (string, optional): Address or location name like "Central Park, New York" - `type` (string, optional): Place type like "restaurant", "cafe", "hotel", "atm", "pharmacy" - `radius` (number, optional): Search radius in meters from 1 to 50000 (Default: 5000) - `keyword` (string, optional): Additional search keyword like "24 hour" or "organic" **Note:** Provide either coordinates (latitude + longitude) OR address for location. **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/google-maps/search_nearby" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "latitude": 37.7749, "longitude": -122.4194, "type": "coffee_shop", "radius": 1000, "keyword": "wifi" }' ``` ### Get Reviews Retrieve customer reviews and ratings for a specific business or place. **Tool Name:** `get_reviews` **Credits Required:** 1 **Parameters:** - `place_id` (string, required): Google Place ID like "ChIJN1t_tDeuEmsRUsoyG83frY4" - `language` (string, optional): Language for reviews like "en", "es", "fr" (Default: "en") - `sort_by` (string, optional): Sort order - "most_relevant", "newest", "highest_rating", "lowest_rating" (Default: "most_relevant") **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/google-maps/get_reviews" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "language": "en", "sort_by": "newest" }' ``` **Response Includes:** - Review text and rating (1-5 stars) - Author name and profile - Review date and time - Helpful votes count - Photos attached to reviews - Owner response if available ## Authentication All API requests require a Bearer token for authentication: ```bash -H "Authorization: Bearer YOUR_API_KEY" ``` ## Rate Limiting - All tools (search_places, get_place_details, search_nearby, get_reviews): 1 credit per request - Rate limit: 1000 requests per hour - Concurrent requests: Up to 10 parallel calls ## Support - **Blog & Tutorials**: https://mcp360.ai/blog - **Contact**: https://mcp360.ai/contact