# Briefs402 Location Brief

> Briefs402 Location Brief is a paid API for AI agents from briefs402.worlddata402.workers.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-29).

Returns a fused intelligence brief for a geographic coordinate, including weather, air quality, timezone, and sunrise/sunset data, written by an LLM under strict no-fabrication rules.

## Facts

- Endpoint: GET https://briefs402.worlddata402.workers.dev/v1/brief/location?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/briefs402-location-brief-d9974c0f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tBfqbzBRBGNrRZN2LIbur

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability briefs402-location-brief-d9974c0f
```

Example prompt: Give me a location intelligence brief for coordinates 30.06 latitude, 31.25 longitude — I want the weather, air quality, timezone, and sunrise info in English.

## When to prefer this

Choose this endpoint when you need a single fused, human-readable intelligence brief combining weather, air quality, timezone, and sunrise data for a lat/lon coordinate — especially when you want LLM-synthesized prose with a confidence rating rather than raw API JSON from separate weather and AQI services. Ideal for agents that need to present location context to end users without stitching multiple data sources together. Requires no API key or account; only USDC on Base mainnet via x402.

## Known failure modes

- Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns a validation error
- Coordinates over open ocean or unpopulated areas may return low-confidence or partial briefs
- Payment failure or insufficient USDC balance on Base mainnet returns a 402 Payment Required response
- Upstream data source outages (weather, AQI APIs) may degrade confidence or omit key_facts fields
- Unsupported lang value (anything other than 'en' or 'ar') returns a validation error

## How this service works

Ready-made intelligence reports for AI agents: company, country, daily market, EU tenders, domain due diligence, location, literature review, food product, package risk and document translation briefs. Each brief fuses several live data sources and is written by Llama 3.3 70B under strict no-fabrication rules (English or Arabic). USDC on Base mainnet over x402. No API key, no account.

## Output

A structured JSON brief with a subject (place name), key facts (timezone, current weather condition, European AQI with label, sunrise time in local time, temperature in Celsius), and a confidence rating. Written in English or Arabic depending on the lang parameter.

## Request schema (JSON Schema)

```json
{
 "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": [
      "lat",
      "lon"
     ],
     "properties": {
      "lat": {
       "type": "number",
       "maximum": 90,
       "minimum": -90,
       "description": "Latitude"
      },
      "lon": {
       "type": "number",
       "maximum": 180,
       "minimum": -180,
       "description": "Longitude"
      },
      "lang": {
       "enum": [
        "en",
        "ar"
       ],
       "type": "string",
       "default": "en",
       "description": "Output language of the summary: en (default) or ar (Arabic)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "subject": "Cairo, Egypt",
  "key_facts": {
   "timezone": "Africa/Cairo",
   "condition": "clear sky",
   "european_aqi": "62 (poor)",
   "sunrise_local": "06:02",
   "temperature_c": 24.1
  },
  "confidence": "high"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/briefs402-location-brief-d9974c0f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from briefs402.worlddata402.workers.dev](https://www.zero.xyz/host/briefs402.worlddata402.workers.dev/llms.txt)
