io.github.uponex/gisgp

PAID (150 credits) — render an ad-hoc GeoJSON FeatureCollection to a one-page PDF report (static map + property table, base64-encoded PDF). Separate from the web app's own PDF Builder (AGOL-service-tied, quota- gated there) — this is for GeoJSON an agent already has in hand. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, pdf_base64, feature_count, truncated, size_bytes}.

Extract coded value domains from an ArcGIS FeatureServer layer. Returns JSON: {"layer_name": ..., "domains": {field: {name, field_alias, codes}}}.

Scan an ArcGIS FeatureServer layer for common problems: missing ObjectID, disabled query, stale data, all-null fields, features without geometry. Sample-based (first 200 records). Returns JSON: {layer_name, issues:[{severity, code, message}], issue_count, sample_size, note}.

Repair invalid geometries (self-intersections, bad rings) via GEOS make_valid. Already-valid geometries are left untouched. Returns JSON {ok, fixed_count, feature_count, geojson}.

Convert a FlatGeobuf file (base64-encoded .fgb) to a GeoJSON FeatureCollection. FlatGeobuf is a cloud-native binary format with a built-in spatial index, used for fast HTTP-range-request streaming (e.g. deck.gl, MapLibre, QGIS cloud layers). Returns the GeoJSON FeatureCollection as a JSON string.

Express one WGS84 point in every common notation at once: decimal degrees, DMS, DDM, UTM (zone/band/easting/northing), MGRS and USNG, British National Grid reference (inside GB only), Geohash, Plus Code, Web Mercator metres, the ArcGIS Online "lon, lat" form, the best local UTM EPSG code, plus ready-to-open Google Maps / Street View / Google Earth / Apple / Bing / OpenStreetMap / Waze links. Pure computation. mgrs_precision: 1-5 digit pairs (10 km ... 1 m), default 5. Returns JSON: {ok, decimal_degrees, dms, ddm, utm, mgrs, usng, bng, geohash, plus_code, web_mercator, agol_format, local_utm_epsg, links}.

Complete one-call QA report: A-F grade + full audit (health/fields/ domains/summary) + issue scan, merged into one response — replaces 3 separate calls (grade_service + audit_service + find_layer_issues). Returns JSON: {ok, grade, score, categories, archetype, insight, percentile, share_url, audit: {name, health, fields, domains, summary}, issues, issue_count}.

GISGP Lite (a 24-hour pass, a 7-day pass or a monthly plan) — pass the api_key of that account (or Authorization: Bearer). contour lines for a box `bbox=[west, south, east, north]` (degrees) or a GeoJSON `polygon`, from Copernicus 30 m (`source="cop30"`, worldwide, up to 100 km² per box) or USGS 10 m (`"usgs10"`, US, up to 25 km²). `interval` in `units` ("m" or "ft"; omit for an automatic interval), `format` geojson | kml | kmz | shp | dxf | dxf3d | landxml | preview, `crs` an EPSG code for the DXF / LandXML (default: the UTM zone). Returns JSON: GeoJSON with stats for geojson/preview; for files {ok, filename, data_base64} or {ok, download_url}.

Render a GeoJSON FeatureCollection/Feature to a static PNG map image (base64 data URL) — for embedding in reports/emails/documents, unlike share_map's interactive live page. basemap: 'topo', 'streets', or 'satellite'. Reuses the exact rendering path already used inside PDF map reports, no new map-rendering logic. Optional agol_token: for a single-Point input, renders through Esri's own Static Maps Service instead (real ArcGIS basemap tiles) — uses YOUR OWN AGOL credentials/quota, not GISGP's (multi-feature/non-point input always uses the default renderer regardless of token). Returns JSON: {ok, image_data_url, feature_count, width, height, basemap}.

Forward-geocode a free-text address to lon/lat. Default: OSM Nominatim (no key, free, fair-use rate limited) — the complement to analyze_location's reverse geocode. Optional agol_token: route through Esri's own World Geocoding Service instead for more authoritative matches — uses YOUR OWN AGOL credentials/quota, not GISGP's (no extra charge either way, no GISGP account needed for this option). Returns JSON: {ok, lon, lat, display_name, type, importance, source}.

Compare two GeoJSON FeatureCollections — added/removed/changed features. Matched by an `id_field` property if given, else by array position (exact structural comparison, not topological equals). Returns JSON {ok, added, removed, changed, added_count, removed_count, changed_count, unchanged_count}.

Convert GeoJSON to CSV/spreadsheet — one row per feature, properties as columns, geometry flattened into a column (e.g. "turn this GeoJSON into Excel/CSV", "I need a spreadsheet from these map features", "export GeoJSON as a table"). Returns the CSV as plain text.

Convert GeoJSON to an AutoCAD DXF file — e.g. "export this GeoJSON to DXF for AutoCAD", "GIS data to CAD format", "convert to .dxf for Civil 3D". Points become DXF POINT entities; lines and polygon rings become LWPOLYLINE entities. A feature's properties.layer (if present) is written back as the DXF entity's layer (group code 8), defaulting to layer "0" otherwise.

Convert GeoJSON to FlatGeobuf (.fgb) — the cloud-native binary format with a built-in spatial index. FlatGeobuf holds one geometry type per file, so mixed point/line/polygon input is automatically split into one .fgb per category and returned inside a zip. Returns JSON: {flatgeobuf_base64|flatgeobuf_zip_base64: str, split: bool, split_categories: [str]|null}.

Convert GeoJSON to a GPX file — e.g. "export this as a GPS track", "GeoJSON to GPX for my Garmin", "make waypoints from this GeoJSON". Points become GPX waypoints; lines and polygon rings become GPX tracks (GPX has no native polygon type). Non-name properties are dropped — GPX has no generic attribute-table equivalent.

Convert GeoJSON to KML for Google Earth / Google My Maps (e.g. "open this in Google Earth", "GeoJSON to KML", "make this viewable in Google My Maps"). Returns the KML as plain text.

Convert GeoJSON to a MapInfo TAB file set, ready for MapInfo Pro. TAB is a multi-sidecar-file format (.tab/.dat/.id/.map) and single geometry type per file, like Shapefile — always returned as a zip, mixed point/line/polygon input is split into one .tab set per category. Returns JSON: {mapinfo_tab_zip_base64: str, split: bool, split_categories: [str]|null}.

Convert GeoJSON to an Esri Shapefile ZIP — the format ArcGIS Desktop Pro/QGIS/most legacy GIS software still expects (e.g. "I need a shapefile for ArcGIS Pro", "GeoJSON to SHP", "convert for QGIS import"). Returns JSON: {shapefile_zip_base64, warnings}.

Convert a GeoJSON geometry (or a Feature's geometry) to WKT — the format needed to insert geometry into PostGIS/SQL (e.g. "I need this for a PostGIS INSERT", "GeoJSON to WKT", "geometry as WKT string").

Complete one-call GeoJSON health check: validate + auto-repair invalid geometry + stats (area/length/vertices) + bbox envelope, merged — replaces 4 separate calls (validate_geojson + fix_geometry + geometry_stats + envelope_geojson). Returns JSON: {ok, valid, errors, warnings, fixed_count, stats, envelope, geojson} where geojson is the (possibly auto-fixed) input.

Compute area (m²/km²), length (m/km), vertex count, centroid and bbox of GeoJSON. Metric measurements use an equal-area projection so area/length are real metres.

Reproject a DXF drawn in a local/arbitrary CAD coordinate system into real-world coordinates — e.g. "this DXF isn't in real coordinates, fix it", "georeference this site plan", "I know 2 points on this drawing's real location, convert the rest". Give exactly 2 control points as a JSON array: '[{"local":[x,y],"real":[lon,lat]}, {"local":[x,y],"real":[lon,lat]}]' — a 2-point similarity transform (uniform scale + rotation + translation) is solved and applied to every coordinate. Returns a GeoJSON FeatureCollection in the real coordinate system implied by the 2 points.

Daily historical weather for a point/date range via Open-Meteo's ERA5-based archive (no key, free, data back to 1940). Dates are YYYY-MM-DD. Returns JSON: {ok, daily: {time, <variables>...}, source}.

GISGP Lite (a 24-hour pass, a 7-day pass or a monthly plan) — pass the api_key of that account (or Authorization: Bearer). height above mean sea level of one point from Copernicus GLO-30 (30 m), read from the public elevation model (GLO-90 fallback). Returns JSON {ok, elevation_m, source, resolution_m, credit}; elevation_m is null at sea. For a free, coarser answer use get_terrain_profile.

PAID (50 credits) — elevation PROFILE along a line, not a single point: pass points=[[lon,lat],…] (up to 100) or start=[lon,lat] + end=[lon,lat] with samples (2-100, evenly spaced). Returns every point's elevation and distance plus min/max, total gain/loss, net change, mean and max segment slope. For "how steep is this route", "line-of-sight terrain between two towers", "elevation change along this pipeline/trail". Copernicus DEM GLO-90 via Open-Meteo (~90 m). The free get_terrain_profile gives one point; this gives the whole line + the maths. Needs an API key with credits — use estimate_cost first. Returns JSON: {ok, points, distance_m, min/max/start/end_elevation_m, total_gain_m, total_loss_m, net_change_m, mean_slope_pct, max_segment_slope_pct, profile:[{i, lon, lat, distance_m, elevation_m}]}.

Nearest USGS real-time stream/river gauge to a point (US rivers and streams only): live streamflow (ft3/s) and gauge height (ft), reported honestly as provisional USGS data — no derived flood-risk score, since USGS does not publish per-site flood-stage thresholds through this API. First real-time (not static/historical) primitive in the catalog. No key needed. Returns JSON: {ok, found, site_name, site_no, distance_miles, streamflow_cfs, gauge_height_ft, observation_time, source, note}.

Get the ground elevation (metres above sea level) at a coordinate — e.g. "what's the elevation here", "is this point in a flood-risk lowland", "elevation at this address". Via Open-Meteo (Copernicus DEM GLO-90, no key, free, ~90m resolution). Returns JSON: {ok, lon, lat, elevation_m, source}.

Convert a GPS track file (GPX) directly to CSV (2026-09-03) — waypoints get LATITUDE/LONGITUDE columns, tracks/routes get a GEOMETRY_WKT column instead.

Convert a GPS track/route file (GPX — from Garmin, Strava exports, hiking/cycling apps, waypoints) to GeoJSON (e.g. "convert my GPS track to GeoJSON", "GPX to GeoJSON", "import my Strava route"). Returns the GeoJSON FeatureCollection as a JSON string.

Convert a GPS track file (GPX) directly to KML for Google Earth — e.g. "open my Garmin/Strava track in Google Earth", "GPX to KML".

Convert a GPS track file (GPX) directly to an Esri Shapefile ZIP — waypoints become points, tracks/routes become lines (2026-09-03). Returns JSON: {shapefile_zip_base64, warnings}.

Grade an ArcGIS FeatureServer layer A–F across 5 categories (schema quality, data completeness, performance, maintenance, configuration). Returns JSON: {grade, score, categories:[{key, label, score, note}], archetype, insight, percentile, share_url} — share_url is a public scorecard page you can send to a human. token: only for private layers (never stored in the scorecard).

GISGP Lite (a 24-hour pass, a 7-day pass or a monthly plan) — pass the api_key of that account (or Authorization: Bearer). which coordinate reference system puts these easting/northing rows where they belong. `lines` are text rows such as "P-7 690183.66, 4729859.76" (up to 1,000); say roughly where with `country` ("Kenya") or `lat`/`lon`. Returns JSON {ok, confidence: high|medium|low|none, candidates: [{epsg, name, area, swapped, national, km, lat, lon}], rows, bad_rows}. Then convert with the chosen EPSG via reproject_geojson or /api/v1/crs/apply.

Best-guess candidate CRS for raw [x, y] coordinates with no metadata (e.g. a shapefile with a missing .prj) — real demand signal (79k+ views on GIS StackExchange). Genuinely ambiguous by nature — returns ranked candidates with an honest 'not a certain identification' caveat, never a single confident answer. Pure computation, no external API. Returns JSON: {ok, x_range, y_range, candidates, note}.

Convert Google Earth / Google My Maps KML (2.0–2.2) to GeoJSON — the common request when someone exported a map from Google Earth or Google My Maps and needs it in a format other GIS tools/APIs accept (e.g. "convert my Google Earth file to GeoJSON", "KML to GeoJSON"). Returns the GeoJSON FeatureCollection as a JSON string.

Convert a Google Earth/My Maps KML file directly to GPX — waypoints from Points, tracks from Lines/Polygons — e.g. "KML to GPX for my Garmin", "load this map on my GPS" (2026-09-03, completes the reverse of the existing gpx_to_kml).

Convert a Google Earth/My Maps KML file directly to an Esri Shapefile ZIP — e.g. "Google Earth file to shapefile for ArcGIS", "KML to SHP". Returns JSON: {shapefile_zip_base64, warnings}.

List the distinct DXF layer names used in a drawing — e.g. "what layers does this DXF have", "list layers before I extract one". Real CAD exports organize entities into named layers (BOUNDARY, UTILITIES, TEXT, ...); use the result with dxf_to_geojson's `layer` param to pull out just one. Returns a JSON array of layer name strings.

Convert a MapInfo TAB file set (base64-encoded .zip containing .tab + its .dat/.map/.id sidecar files) to a GeoJSON FeatureCollection. MapInfo TAB is the native format of MapInfo Pro — a multi-file format on disk, always uploaded as a zip. Returns the GeoJSON FeatureCollection as a JSON string.

Smallest-area rectangle wrapping all input features combined — can be tilted to fit tighter than a straight bounding box (e.g. "tightest rectangle around this data", "minimum bounding rectangle", "oriented bounding box"). Returns JSON {ok, geojson}.

For each feature in A, find the nearest feature in B by centroid-to- centroid geodesic distance. Attaches `_nearest` properties and `_nearest_distance_m`. Returns JSON {ok, geojson}.

Move a WGS84 point by a geodesic distance (metres) along a compass bearing (0=N, 90=E, 180=S, 270=W). Pure computation, no external API. Returns JSON: {ok, lon, lat, origin_lon, origin_lat, distance_m, bearing_deg, source}.

Combine two GeoJSON FeatureCollections with a boolean set operation. op: intersection | difference (a minus b) | symmetric_difference | union. Each side is unioned into one geometry first, then the operation is applied. Returns JSON {ok, op, geojson} — empty geojson means no overlap, not an error.

Parse ANY single coordinate string a human might paste into WGS84 lat/lon — decimal degrees with any separator or an EU decimal comma, DMS (42°41'51.7"N 23°19'18.9"E), DDM / GPS style (N 42° 41.535'), NMEA (4241.535,N,02319.314,E), UTM with a zone/band (34T 583000 4727000), MGRS (34TFN8300027000), British grid refs (TQ 30 80), Geohash, full Plus Codes, and Google/Apple/Bing/OSM map links. Detects lon,lat order from hemisphere letters, labels or out-of-range values and says so in `note`. Deterministic, no LLM — LLMs are unreliable past 2-3 decimals; this is exact. Ambiguous input (e.g. "583000 4727000" with no zone) is an error with a concrete hint, never a guess. Returns JSON: {ok, kind, label, lat, lon, note, ...notation fields}.

GISGP Lite (a 24-hour pass, a 7-day pass or a monthly plan) — pass the api_key of that account (or Authorization: Bearer). a legal description → where it is: `q` like "T2N R3E Sec 14", "NW¼ SE¼ Sec 12 T3N R4W", "Township 1 North, Range 2 East" or BLM-coded "1460N 0920W SEC 8"; `state` the two-letter code (tried in every PLSS state when empty). Returns JSON {ok, results: [{label, state, lat, lon, bbox, plssid, geometry…}], read_as, notes}.

GISGP Lite (a 24-hour pass, a 7-day pass or a monthly plan) — pass the api_key of that account (or Authorization: Bearer). US Public Land Survey System township, range, section and meridian at a point (BLM CadNSDI). Returns JSON {ok, found, township, range, section, meridian, plssid, …} or {ok, found: false, note}.

Fetch actual feature records (attributes + geometry) from a FeatureServer layer. Free preview capped at 50 records (WHERE filter + chosen fields). Returns JSON: {returned, total, truncated, geojson, note}. Full unlimited export is a paid operation.

Server-side aggregate stats on a numeric field of a FeatureServer layer. No records fetched — AGOL computes sum/avg/min/max/count (also stddev/var). Optional WHERE filter and group_by field. Returns JSON: {field, results:[...]}. Cheap way to answer "what's the average/total of field X" without an export.

PAID (200 credits PER CANDIDATE, max 25 candidates/call) — bulk seismic- risk screener. Runs assess_property_hazard's seismic check under the hood for each [lon, lat] candidate and returns only the top_n ranked by lowest real seismic risk (PGA). Not a full multi-hazard ranking — ranked by ONE real, single-source metric only (matches this project's no-invented- composite-score stance); disaster_history_10y/active_weather_alerts are still included per-candidate for context. Use estimate_cost(tool_name= "rank_hazard_safe_sites", units=<candidate count>) first to quote. Requires Authorization: Bearer <api_key>. Returns JSON: {ok, evaluated, excluded_count, excluded, ranked_by, top, note}.

Bulk solar/wind site screener — evaluates up to 25 candidate points (each {"lon": ..., "lat": ...}) and returns only the top_n, ranked by average daily solar radiation. Candidates with unsuitable land cover (urban/water/snow) or no substation nearby are filtered out, not silently scored low. No invented composite score. No key needed. Returns JSON: {ok, evaluated, excluded_count, excluded, ranked_by, top}.