Aller au contenu
API Boundaries + Areas, conçue pour les agents

Chaque limite sur Terre, en un appel d’API.

Ou décrivez simplement la zone.

Obtenez le polygone de n’importe quel pays, État, comté, ville, quartier ou code postal, par nom ou par point. Ou envoyez une phrase, ou la formulation d’un contrat, et récupérez un polygone validé, ou un refus clair.

1 000 unités gratuites par mois. Sans carte bancaire. La recherche ne nécessite pas de clé.

Essayez
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 parties, 17 765 km²

Deux produits, une seule clé

Boundaries quand vous connaissez le lieu. Areas quand vous n’avez que les mots.

Boundaries

N’importe quelle limite administrative OpenStreetMap, des pays aux quartiers et codes postaux. Recherchez par nom, faites du géocodage inverse sur un point, parcourez parents et enfants, testez des points, fusionnez des formes, et exportez en GeoJSON, KML, WKT, GML ou SVG.
  • Recherche par nom, gratuite
  • Polygone pour 1 unité
  • Recherche inverse par point
  • Tests point-dans-polygone par lots
  • Parents et enfants
  • Fusion en une seule forme

Areas

Les contrats et les réglementations nomment rarement une seule limite. Un agent IA lit la description, associe chaque lieu à une limite réelle et valide le résultat. 50 unités par zone.
  • Territoires par liste
    « les comtés d’Alameda, de Contra Costa et de Santa Clara »
  • Exclusions
    « …à l’exclusion de la ville de San José »
  • Sites
    « …et l’emprise de l’aéroport »
  • Limites historiques
    « l’ancienne commune, telle qu’elle était avant la fusion de 2004 »
  • Priorité
    « …sans préjudice des règles locales »
  • Toutes les langues
    « 函館市及び北斗市の区域 »

Un seul appel

D’un nom à un polygone

La recherche est gratuite et ne nécessite pas de clé. Une géométrie coûte une unité et reste en cache pour tout le monde après la première requête.

Obtenir la limite de Berlin en GeoJSON

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

Ou décrivez la zone

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"}'

Cas difficiles

Les formulations qui font échouer les géocodeurs

Treize descriptions, d’une expression de quatre mots à des avis tarifaires japonais et des décrets espagnols sur les taxis, chacune envoyée telle qu’elle est écrite. Chaque carte et chaque verdict est la sortie réelle de l’API, y compris les refus. Exécutez-les vous-même.

🇺🇸 Baie de San Francisco, États-Unis

Une région nommée en quatre mots

Accepté
SF Bay area counties
Alameda CountyContra Costa CountyMarin CountyNapa CountySan Francisco CountySan Mateo CountySanta Clara CountySolano CountySonoma CountySF Bay Area (9 counties)
Superficie
18 230 km²
Niveau
metro

Parties

Le piège

Aucun comté, État ni pays n’est nommé. « SF Bay area » doit être compris comme la région standard des neuf comtés.

Ce que fait Geocode AI

Comprend que le texte parle des États-Unis et cartographie les neuf comtés en une seule zone terrestre : environ 18 200 km².

Accepté ou refusé. Jamais deviné.

Un territoire tracé trop grand applique un contrat là où il ne s’applique pas ; trop petit, il oublie des lieux. Il n’y a donc pas d’entre-deux : un polygone exploitable, ou une erreur qui explique pourquoi.

  • Accepté

    Accepté

    Chaque lieu de la description a été cartographié et le polygone a passé la validation : l’API renvoie HTTP 200 avec le GeoJSON.

  • Refusé · 422

    Refusé, avec motifs

    Si un lieu ne peut pas être cartographié, ou si le résultat échoue à la validation, il n’y a pas de polygone : la HTTP 422 indique exactement ce qui n’a pas pu être cartographié et pourquoi.

Comment fonctionne Areas

  1. 01

    Lire

    Lit la description et détermine les lieux à inclure et à exclure : comtés, villes, quartiers, aéroports.

  2. 02

    Cartographier

    Trouve la limite précise de chaque lieu, découpée au trait de côte, et vérifie qu’il s’agit du bon type de lieu et d’une taille plausible.

  3. 03

    Valider

    Les tailles, votre point de référence, les chevauchements et les mises à jour de zones existantes sont validés. Vous n’obtenez un polygone que s’il tient la route.

D’un PDF à une zone interrogeable

Une vraie résolution tarifaire de la mairie de La Corogne. Extrayez la clause qui définit où elle s’applique, envoyez-la à l’API et stockez le polygone. Dès lors, « ce tarif s’applique-t-il ici ? » se résume à une requête dans votre propre base de données.

  1. 01 · Extraire la clause

    resolucion.pdfp. 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"

    N’importe quel outil PDF vers texte convient. La clause est envoyée telle quelle, en galicien.

  2. 02 · Envoyez-la à POST /v1/areas

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

    La commune, et non la comarca de 473 km² que la plupart des jeux de données appellent « A Coruña ». Renvoyée en GeoJSON.

  3. 03 · Interrogez-la dans votre stack

    -- 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));
    Gare de La Corogne

    43.3536, -8.4095

    Tarif urbain
    Tour d’Hercule

    43.3859, -8.4065

    Tarif urbain
    Aéroport de La Corogne, à Culleredo

    43.3021, -8.3773

    Hors zone

    Exemple avec PostGIS. Toute bibliothèque SIG ou base de données qui lit le GeoJSON convient.

Conçu pour les agents

Votre agent sait déjà s’en servir

Chaque opération a un seul nom et un seul schéma d’entrée sur REST, MCP, la CLI et les plugins, avec des descriptions rédigées pour un modèle qui choisit un outil.

Cas d’usage

Partout où une règle suit une frontière

Tarification

Payez la géométrie, pas la recherche

Une unité correspond à une géométrie de limite, une recherche inverse, un export ou 1 000 tests de points. La recherche et la hiérarchie sont gratuites. Une zone décrite coûte 50 unités.

Free

Pour les prototypes et les agents qui découvrent l’API.

0 $US/ mois

  • 1 000 unités par mois
  • 60 requêtes par minute
  • Jusqu’à 20 zones décrites
  • REST, MCP, CLI et plugins
  • Sans carte bancaire

Pro

Pour la production
Pour les applications en production.

29 $US/ mois

ou 290 $US par an, soit deux mois offerts

  • 50 000 unités par mois
  • 600 requêtes par minute
  • Jusqu’à 1 000 zones décrites
  • REST, MCP, CLI et plugins

Business

Pour les pipelines à fort volume et les exports en masse.

199 $US/ mois

ou 1 990 $US par an, soit deux mois offerts

  • 1 000 000 unités par mois
  • 3 000 requêtes par minute
  • Jusqu’à 20 000 zones décrites
  • REST, MCP, CLI et plugins

Enterprise

Données auto-hébergées, SLA et jeux de limites sur mesure.

Personnalisé

  • Unités illimitées
  • 10 000 requêtes par minute
  • Areas sur contrat
  • REST, MCP, CLI et plugins
  • Données auto-hébergées, SLA, jeux de limites sur mesure

Comparer les plans en détail

Questions

Transformez noms de lieux et petits caractères en cartes fiables.

Zones de service, juridictions fiscales, zones tarifaires, zones de couverture : partout où une règle est définie par un lieu.