{"uid":"cap_bYZXUZ3e-TyCsM8g2Hc1f","slug":"photographer-guide-night-shoot-planner-d4e0ac65","name":"Photographer Guide Night Shoot Planner","description":"Photographer Guide: plans a night-photography shoot from a GPS position using live cloud-cover forecasts, moon phase, astronomical darkness and the meteor-shower calendar. Returns scored shooting locations, a driving route with timing, en-route photo stops, a minute-by-minute schedule and an AI narrative.","url":"https://photographer-guide.whkirl.workers.dev/plan","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["location"],"properties":{"date":{"type":"string","description":"YYYY-MM-DD evening of the shoot. Default: next meteor-shower peak within 14 days, else tonight."},"target":{"enum":["meteor_shower","milky_way","stars","sunset","auto"],"type":"string","description":"What to photograph. Default: auto."},"location":{"type":"string","description":"GPS \"lat,lon\" (e.g. \"37.77,-122.42\") or a place name (e.g. \"Yosemite Valley\")"},"maxDriveMinutes":{"type":"number","description":"Max one-way drive time (15–240). Default 90."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LuOJi239BrGBeK7soYtFO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Plans a night photography shoot from a GPS location using live cloud cover, moon phase, astronomical darkness, and meteor shower calendar to return scored locations, a driving route, a minute-by-minute schedule, and an AI narrative.","exampleAgentPrompt":"Plan a meteor shower night photography shoot for me on August 12 starting from Yosemite Valley, with a max 60-minute drive, targeting meteor showers — give me scored dark-sky spots, a route, and a minute-by-minute shooting schedule.","exampleUseCases":[{"title":"Meteor shower shoot from city outskirts","prompt":"I want to photograph the Perseid meteor shower on August 12th — I'm in Los Angeles and can drive up to 90 minutes. Can you find me the best dark-sky locations, plan a driving route with photo stops, and give me a schedule for the night?"},{"title":"Milky Way session near national park","prompt":"Plan a Milky Way photography outing for this Saturday starting from Moab, Utah — I can drive up to 45 minutes. Tell me the best spots, the best window of astronomical darkness, moon phase, and cloud cover."},{"title":"Spontaneous stars shoot tonight","prompt":"I want to go photograph stars tonight from my location at 37.77,-122.42 — find me the closest dark-sky spots within a 60-minute drive, check the cloud cover, and give me a minute-by-minute shooting schedule for tonight."}],"resultDescription":"Returns a structured plan including: scored shooting locations ranked by darkness and accessibility, a driving route with turn-by-turn timing, en-route photo stops, a minute-by-minute shoot schedule aligned to astronomical events (darkness windows, moon rise/set, meteor shower peaks), live cloud cover forecasts per location, moon phase data, and a human-readable AI narrative summarizing the recommended plan.","failureModes":["Location not found or unresolvable place name — returns error on location field","No viable dark-sky windows due to full overcast forecast — may return low-scored locations only","Date out of range or malformed (not YYYY-MM-DD) — validation error","maxDriveMinutes outside 15–240 range — rejected with parameter error","No meteor showers within 14 days when target is meteor_shower — may fall back to stars or return empty schedule","Service unavailable or worker timeout — HTTP 5xx error"],"whenToPreferThis":"Choose this endpoint when a user wants a complete, actionable night photography plan — not just raw weather or astronomy data. It uniquely combines cloud cover forecasts, moon phase, astronomical darkness windows, meteor shower calendars, driving routing, and AI narrative into a single scored, scheduled itinerary. Prefer it over standalone weather APIs, dark-sky finders, or astronomy apps when the user needs a ready-to-execute shoot plan with locations and timing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:32:14.116Z","isFirstParty":false}