POST https://api.nimbleway.com/v1/maps

curl -X POST "https://api.nimbleway.com/v1/maps" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "restaurants near me",
    "location": "New York, NY"
  }'

{
  "status": "success",
  "query": "restaurants near me",
  "location": "New York, NY",
  "results": [
    {
      "name": "Joe's Pizza",
      "address": "123 Main St, New York, NY 10001",
      "phone": "+1 (555) 123-4567",
      "website": "https://joespizza.com",
      "rating": 4.5,
      "reviews_count": 1247,
      "price_level": "$$",
      "category": "Pizza Restaurant",
      "hours": {
        "monday": "11:00 AM - 10:00 PM",
        "tuesday": "11:00 AM - 10:00 PM",
        "wednesday": "11:00 AM - 10:00 PM"
      },
      "coordinates": {
        "lat": 40.7589,
        "lng": -73.9851
      },
      "place_id": "ChIJd8BlQ2BZwokRAFQXSW2xTsQ"
    }
  ]
}

{
  "query": "coffee shops",
  "location": "San Francisco, CA",
  "radius": "5km",
  "limit": 20
}

{
  "place_id": "ChIJd8BlQ2BZwokRAFQXSW2xTsQ",
  "include_reviews": true,
  "include_photos": true
}

{
  "query": "gas stations",
  "coordinates": {
    "lat": 37.7749,
    "lng": -122.4194
  },
  "radius": "2km"
}

{
  "name": "Business Name",
  "address": "Full address",
  "phone": "+1 (555) 123-4567",
  "website": "https://business.com",
  "email": "[email protected]",
  "category": "Restaurant",
  "subcategory": "Italian Restaurant",
  "rating": 4.3,
  "reviews_count": 856,
  "price_level": "$$"
}

{
  "hours": {
    "monday": "9:00 AM - 9:00 PM",
    "tuesday": "9:00 AM - 9:00 PM", 
    "wednesday": "9:00 AM - 9:00 PM",
    "thursday": "9:00 AM - 9:00 PM",
    "friday": "9:00 AM - 10:00 PM",
    "saturday": "10:00 AM - 10:00 PM",
    "sunday": "10:00 AM - 8:00 PM"
  },
  "current_status": "open",
  "next_status_change": "closes at 9:00 PM"
}

{
  "reviews": [
    {
      "author": "John D.",
      "rating": 5,
      "date": "2024-01-15",
      "text": "Great food and excellent service!",
      "helpful_votes": 12
    }
  ],
  "rating_breakdown": {
    "5_star": 45,
    "4_star": 30,
    "3_star": 15,
    "2_star": 7,
    "1_star": 3
  }
}

{
  "photos": [
    {
      "url": "https://maps.gstatic.com/photo123.jpg",
      "width": 1200,
      "height": 800,
      "type": "exterior"
    },
    {
      "url": "https://maps.gstatic.com/photo456.jpg", 
      "width": 800,
      "height": 600,
      "type": "interior"
    }
  ]
}

{
  "query": "restaurants",
  "location": "Downtown Seattle",
  "limit": 100,
  "include_reviews": true,
  "min_rating": 4.0
}

{
  "query": "your business category",
  "location": "your city",
  "radius": "10km",
  "include_reviews": true
}

{
  "query": "coffee shops",
  "location": "potential expansion city",
  "limit": 50,
  "price_level": "$$"
}

{
  "place_id": "your_business_place_id",
  "include_reviews": true,
  "review_limit": 100
}

{
  "query": "hotels",
  "locations": [
    "New York, NY",
    "Los Angeles, CA", 
    "Chicago, IL"
  ],
  "limit": 10
}

{
  "query": "food",
  "location": "Miami, FL",
  "categories": ["restaurant", "cafe", "bakery"],
  "exclude_categories": ["fast_food"]
}

{
  "query": "trending restaurants",
  "location": "Austin, TX",
  "sort_by": "popularity",
  "time_filter": "week"
}

const results = await client.maps({
  query: 'coffee shops',
  location: 'Portland, OR',
  limit: 25,
  include_reviews: true,
  min_rating: 4.0
});

results.forEach(place => {
  console.log(`${place.name} - ${place.rating}⭐`);
});

results = client.maps({
    'query': 'coffee shops',
    'location': 'Portland, OR',
    'limit': 25,
    'include_reviews': True,
    'min_rating': 4.0
})

for place in results:
    print(f"{place['name']} - {place['rating']}⭐")

{
  "status": "error",
  "error": "LOCATION_NOT_FOUND",
  "message": "Could not find location: 'Invalid City Name'"
}

{
  "status": "success",
  "results": [],
  "message": "No businesses found matching criteria"
}

{
  "status": "error",
  "error": "RATE_LIMIT_EXCEEDED",
  "message": "Maps API rate limit exceeded",
  "retry_after": 3600
}