Zum Inhalt springen
Boundaries + Areas API, gebaut für Agents

Jede Grenze der Erde, ein API-Aufruf.

Oder beschreiben Sie einfach das Gebiet.

Erhalten Sie das Polygon jedes Landes, Bundeslands, Landkreises, jeder Stadt, jedes Bezirks oder jeder Postleitzahl nach Name oder nach Punkt. Oder senden Sie einen Satz oder den Wortlaut eines Vertrags und erhalten Sie ein validiertes Polygon zurück, oder eine klare Ablehnung.

1.000 Einheiten pro Monat kostenlos. Keine Kreditkarte. Die Suche braucht keinen Schlüssel.

Zum Beispiel
Alameda CountyContra Costa CountyMarin CountyNapa CountySan Francisco CountySan Mateo CountySanta Clara CountySolano CountySonoma CountySF Bay Area (excl. San Jose)excluded: San Jose
Areas: „SF Bay area counties excluding San Jose City limits“ → 10 Teile, 17.765 km²

Zwei Produkte, ein Schlüssel

Boundaries, wenn Sie den Ort kennen. Areas, wenn Sie nur die Worte haben.

Boundaries

Jede administrative Grenze aus OpenStreetMap, von Ländern bis zu Bezirken und Postleitzahlen. Suchen Sie nach Name, ordnen Sie einen Punkt per Reverse-Geocoding zu, navigieren Sie durch über- und untergeordnete Grenzen, prüfen Sie Punkte, führen Sie Formen zusammen und exportieren Sie GeoJSON, KML, WKT, GML oder SVG.
  • Suche nach Name, kostenlos
  • Polygon für 1 Einheit
  • Reverse-Lookup per Punkt
  • Point-in-Polygon-Batches
  • Über- und untergeordnete Grenzen
  • Zu einer Form zusammenführen

Areas

Verträge und Vorschriften nennen selten nur eine Grenze. Ein KI-Agent liest die Beschreibung, ordnet jeden Ort einer echten Grenze zu und validiert das Ergebnis. 50 Einheiten pro Gebiet.
  • Gebiete per Liste
    „die Countys Alameda, Contra Costa und Santa Clara“
  • Ausnahmen
    „…ohne die Stadt San Jose“
  • Einrichtungen
    „…und das Flughafengelände“
  • Historische Grenzen
    „der ehemalige Ort, wie er vor der Fusion 2004 bestand“
  • Vorrang
    „…unbeschadet lokaler Regelungen“
  • Jede Sprache
    „函館市及び北斗市の区域“

Ein Aufruf

Vom Namen zum Polygon

Die Suche ist kostenlos und braucht keinen Schlüssel. Eine Geometrie kostet eine Einheit und ist nach der ersten Anfrage für alle gecacht.

Die Grenze von Berlin als GeoJSON abrufen

curl "https://geocodeai.dev/v1/boundaries/r62422?detail=medium" \  -H "Authorization: Bearer $GEOCODE_API_KEY"

Oder das Gebiet beschreiben

curl -X POST "https://geocodeai.dev/v1/areas" \  -H "Authorization: Bearer $GEOCODE_API_KEY" \  -H "Content-Type: application/json" \  -d '{"text":"The municipality of A Coruña, Spain"}'

Schwierige Fälle

Die Formulierungen, an denen Geocoder scheitern

Dreizehn Beschreibungen, von einer Phrase aus vier Wörtern bis zu japanischen Tarifbekanntmachungen und spanischen Taxiverordnungen, jeweils wörtlich gesendet. Jede Karte und jedes Urteil ist die echte Ausgabe der API, auch die abgelehnten. Führen Sie sie selbst aus.

🇺🇸 San Francisco Bay Area, USA

Eine Region, benannt in vier Wörtern

Akzeptiert
SF Bay area counties
Alameda CountyContra Costa CountyMarin CountyNapa CountySan Francisco CountySan Mateo CountySanta Clara CountySolano CountySonoma CountySF Bay Area (9 counties)
Fläche
18.230 km²
Ebene
metro

Teile

Der Haken

Weder County noch Bundesstaat noch Land werden genannt. „SF Bay area“ muss als die übliche Region aus neun Countys gelesen werden.

Was Geocode AI macht

Erkennt, dass der Text die USA meint, und bildet alle neun Countys als ein reines Landgebiet ab: etwa 18.200 km².

Akzeptiert oder abgelehnt. Nie geraten.

Ein zu groß gezogenes Gebiet wendet einen Vertrag dort an, wo er nicht hingehört; ein zu klein gezogenes lässt Orte aus. Deshalb gibt es kein Dazwischen: ein Polygon, das Sie verwenden können, oder ein Fehler, der sagt, warum nicht.

  • Akzeptiert

    Akzeptiert

    Jeder Ort in der Beschreibung wurde abgebildet und das Polygon hat die Validierung bestanden: Die API gibt HTTP 200 mit dem GeoJSON zurück.

  • Abgelehnt · 422

    Abgelehnt, mit Begründung

    Wenn ein Ort nicht abgebildet werden kann oder das Ergebnis die Validierung nicht besteht, gibt es kein Polygon: HTTP 422 sagt genau, was nicht abgebildet werden konnte und warum.

So funktioniert Areas

  1. 01

    Lesen

    Liest die Beschreibung und ermittelt, welche Orte ein- und welche ausgeschlossen werden: Landkreise, Städte, Bezirke, Flughäfen.

  2. 02

    Abbilden

    Findet die genaue Grenze für jeden Ort, auf die Landfläche zugeschnitten, und prüft, ob es die richtige Art von Ort ist und die Größe plausibel ist.

  3. 03

    Validieren

    Größen, Ihr Referenzpunkt, Überschneidungen und Änderungen an bestehenden Gebieten werden validiert. Sie erhalten nur dann ein Polygon, wenn es standhält.

Vom PDF zur abfragbaren Zone

Ein echter Tarifbeschluss des Stadtrats von A Coruña. Ziehen Sie die Klausel heraus, die den Geltungsbereich festlegt, senden Sie sie an die API und speichern Sie das Polygon. Danach ist „Gilt dieser Tarif hier?“ eine einzige Abfrage in Ihrer eigenen Datenbank.

  1. 01 · Klausel extrahieren

    resolucion.pdfS. 1

    resolve autorizar a aplicación das seguintes tarifas máximas (IVE incluído) para o transporte urbano en auto-taxi para o Concello da Coruña

    pdftotext -layout resolucion.pdf - \  | grep -i "concello da coruña"

    Jedes PDF-zu-Text-Tool funktioniert. Die Klausel wird wörtlich übergeben, auf Galicisch.

  2. 02 · An POST /v1/areas senden

    A CoruñaConcello da Coruña
    Concello da Coruña · 37,1 km²HTTP 200

    Die Gemeinde, nicht die 473 km² große Comarca, die die meisten Datensätze „A Coruña“ nennen. Zurückgegeben als GeoJSON.

  3. 03 · In Ihrem Stack abfragen

    -- store the zone onceINSERT INTO zones (name, geom)VALUES ('A Coruña urban',  ST_GeomFromGeoJSON(:geometry));
    -- then look up any pointSELECT name FROM zonesWHERE ST_Contains(geom,  ST_Point(:lon, :lat, 4326));
    Bahnhof A Coruña

    43.3536, -8.4095

    Stadttarif
    Herkulesturm

    43.3859, -8.4065

    Stadttarif
    Flughafen A Coruña, in Culleredo

    43.3021, -8.3773

    Außerhalb der Zone

    Hier mit PostGIS gezeigt. Jede GIS-Bibliothek oder Datenbank, die GeoJSON liest, funktioniert.

Für Agents gebaut

Ihr Agent weiß schon, wie man es benutzt

Jede Operation hat einen Namen und ein Eingabeschema über REST, MCP, die CLI und die Plugins hinweg, mit Beschreibungen, die für ein Modell geschrieben sind, das ein Tool auswählt.

Anwendungsfälle

Überall, wo eine Regel einer Grenze folgt

Preise

Zahlen Sie für Geometrie, nicht fürs Suchen

Eine Einheit ist eine Grenzgeometrie, ein Reverse-Lookup, ein Export oder 1.000 Punktprüfungen. Suche und Hierarchie sind kostenlos. Ein beschriebenes Gebiet kostet 50 Einheiten.

Free

Für Prototypen und Agents, die es ausprobieren.

0 $/ Monat

  • 1.000 Einheiten pro Monat
  • 60 Anfragen pro Minute
  • Bis zu 20 beschriebene Gebiete
  • REST, MCP, CLI und Plugins
  • Keine Kreditkarte nötig

Pro

Für die Produktion
Für Produktions-Apps.

29 $/ Monat

oder 290 $ pro Jahr, zwei Monate gratis

  • 50.000 Einheiten pro Monat
  • 600 Anfragen pro Minute
  • Bis zu 1.000 beschriebene Gebiete
  • REST, MCP, CLI und Plugins

Business

Für Pipelines mit hohem Volumen und Massenexporte.

199 $/ Monat

oder 1.990 $ pro Jahr, zwei Monate gratis

  • 1.000.000 Einheiten pro Monat
  • 3.000 Anfragen pro Minute
  • Bis zu 20.000 beschriebene Gebiete
  • REST, MCP, CLI und Plugins

Enterprise

Selbst gehostete Daten, SLAs und eigene Grenzsätze.

Individuell

  • Unbegrenzte Einheiten
  • 10.000 Anfragen pro Minute
  • Gebiete per Vertrag
  • REST, MCP, CLI und Plugins
  • Selbst gehostete Daten, SLAs, eigene Grenzsätze

Pläne im Detail vergleichen

Häufige Fragen

Machen Sie aus Ortsnamen und Kleingedrucktem Karten, denen Sie vertrauen können.

Servicegebiete, Steuerhoheitsgebiete, Tarifzonen, Versorgungsgebiete: überall, wo eine Regel durch einen Ort definiert ist.