Name: satellite-tile
Price: 0.005 USDC
Availability: InStock

$ man satellite-tile

agentutility / locale / satellite-tile

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

satellite-tile — returns a recent cloud-free satellite image (sentinel-2, 10m) as a png centered on a lat/lon at a slippy-map zoom level

SYNOPSIS

POST https://x402.agentutility.ai/satellite-tile
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Returns a recent cloud-free satellite image (Sentinel-2, 10m) as a PNG centered on a lat/lon at a slippy-map zoom level. Default source: CDSE Sentinel Hub Processing API with mosaickingOrder=leastCC over the prior 30 days (configurable via days_back); optional NASA GIBS MODIS Terra (~250m) source for regional zoom <=9 with zero quota. Output is JSON: { source, lat, lon, zoom, bbox, data_base64, license, attribution, ... }. License: Copernicus open data (CC BY-SA 3.0 IGO) or NASA public domain; attribution string included in every response. Use it as a satellite imagery tile, lat-lon to satellite PNG, Sentinel-2 tile API, or agent-callable cloud-free satellite snapshot.

INPUT — request schema

property	type	description	req?
lat	number	Latitude in decimal degrees. Range [-90, 90].	required
lon	number	Longitude in decimal degrees. Range [-180, 180].	required
zoom	number	Slippy-map zoom level. 1-16. Default 12 (neighborhood scale). Zoom 13+ at 512px oversamples Sentinel-2's 10m native resolution and may time out on CDSE — use size ≤256 for zoom ≥14, or stay at zoom ≤12 for size 512. MODIS/GIBS supports ≤9 only.	optional
size	number	Output image side length in pixels. 64-2500. Default 256. Higher sizes at high zooms oversample Sentinel-2 — see zoom field.	optional
source	string	Imagery source. 'cdse' (default, Sentinel-2 10m) or 'gibs' (NASA MODIS Terra ~250m, no quota, zoom ≤9 only). enum: cdse · gibs	optional
days_back	number	CDSE only: lookback window for least-cloudy mosaic in days. 7-180. Default 14.	optional

OUTPUT — response shape

field	type	description
source	string	Imagery provider used for this tile, either CDSE Sentinel-2 or NASA GIBS MODIS Terra.
lat	string	Latitude of the tile center in decimal degrees, echoed back from the request.
lon	string	Longitude of the tile center in decimal degrees, echoed back from the request.
zoom	string	Slippy-map zoom level used to compute the tile bounding box.
size	string	Pixel dimensions of the returned PNG, typically expressed as widthxheight.
bbox	string	Geographic bounding box of the tile as [minLon, minLat, maxLon, maxLat] in WGS84 degrees.
time_range	string	Date window searched for cloud-free imagery, e.g. last 30 days ending at request time.
format	string	Image file format of the returned tile, typically png.
content_type	string	MIME type of the encoded image payload, typically image/png.
data_base64	string	Base64-encoded PNG bytes of the cloud-free satellite tile.
bytes	string	Decoded size of the PNG payload in bytes.
license	string	License covering the imagery, Copernicus CC BY-SA 3.0 IGO or NASA public domain.
attribution	string	Required attribution string to display alongside the imagery.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/satellite-tile \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the satellite-tile tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localesatellite-imagerysentinel-2map-tilegeospatiallat-loncloud-freeslippy-map
methods: POST
cluster: locale
price: $0.005 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
air-quality	Returns current air quality readings and AQI category for any latitude/longitude, with optional hourly forecast rows for the next 1-72 hours.	$0.005
airport-code-lookup	Resolves airport codes to airport name, municipality, country, region, coordinates, elevation, scheduled-service flag, homepage, and Wiki…	$0.005
astro-times	Sunrise sunset times.	$0.005
climate-data	Returns historical daily temperature, precipitation, humidity, wind, and solar radiation for any latitude/longitude.	$0.005
country-info	Country info lookup.	$0.005
current-weather	Looks up current weather conditions for a latitude/longitude: temperature, humidity, precipitation, wind, and WMO condition code.	$0.005
holiday-lookup	Holiday calendar.	$0.005
iata-airport-info	Looks up airport metadata from an IATA or ICAO code.	$0.005