French address geocoding on the official Base Adresse Nationale (api-adresse

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x6ab8efe305cce67daa48c97bde29c04402822dff",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "limit": 1,
          "q": "8 boulevard du port amiens"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "count": 1,
          "matches": [
            {
              "city": "Amiens",
              "citycode": "80021",
              "context": "80, Somme, Hauts-de-France",
              "housenumber": "8",
              "label": "8 Boulevard du Port 80000 Amiens",
              "lat": 49.897442,
              "lon": 2.290084,
              "postcode": "80000",
              "score": 0.97072,
              "street": "Boulevard du Port",
              "type": "housenumber"
            }
          ],
          "mode": "search",
          "query": "8 boulevard du port amiens",
          "source": "Base Adresse Nationale via api-adresse.data.gouv.fr (Etalab/IGN, Licence Ouverte 2.0)"
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET",
                "HEAD",
                "DELETE"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "citycode": {
                  "description": "Filter by 5-char INSEE city code",
                  "type": "string"
                },
                "lat": {
                  "description": "Latitude (reverse mode, with lon)",
                  "type": "number"
                },
                "limit": {
                  "description": "Max matches, 1-10 (default 3)",
                  "type": "integer"
                },
                "lon": {
                  "description": "Longitude (reverse mode, with lat)",
                  "type": "number"
                },
                "q": {
                  "description": "Free-text French address (forward mode)",
                  "type": "string"
                },
                "type": {
                  "description": "Restrict match type",
                  "enum": [
                    "housenumber",
                    "street",
                    "locality",
                    "municipality"
                  ],
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://data.greeneris.io/v1/fr/geocode"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://data.greeneris.io/v1/fr/geocode");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://data.greeneris.io/v1/fr/geocode")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header