openapi: 3.0.3
info:
  title: wymmo.dev geocoder
  description: |
    The addresses, the places and the cadastral parcels of France, from text to point and from point to address, as the geocoder
    of the IGN Géoplateforme answers them: same paths, same parameters, same JSON, faster.

    Data, each under the [Licence Ouverte 2.0](https://www.etalab.gouv.fr/licence-ouverte-open-licence):
    - the Base Adresse Nationale (BAN): the addresses;
    - BD TOPO® 3.5 of the IGN, edition of 2026-03-15: the points of interest;
    - ADMIN EXPRESS COG 3.2 of the IGN, 2023-05-03: the commune of each point of interest;
    - Parcellaire Express (PCI) 1.1 of the IGN, from the cadastral plan of the DGFiP, edition of 2026-06-01: the cadastral parcels;
    - the official geographic code 2025 of the Insee, through `@etalab/decoupage-administratif` 5.3.0: the names and codes of the communes.

    Who reuses the answers credits each source and its date: see [wymmo.dev/licences](https://wymmo.dev/licences).

    For a few seconds after a restart, a query may answer 503: retry later.
    The version below is the one of this contract; its changes and the notice given before a route or a parameter is removed are told by the terms of service.
  termsOfService: https://wymmo.dev/tos
  license:
    name: Licence Ouverte 2.0
    url: https://www.etalab.gouv.fr/licence-ouverte-open-licence
  contact:
    email: contact@wymmo.com
    url: https://wymmo.dev/contact
  version: 1.0.0
externalDocs:
  description: The service of the State this API stands in for
  url: https://geoservices.ign.fr/documentation/services/services-geoplateforme/geocodage
servers:
- url: https://api.wymmo.dev/geocodage
tags:
- name: geocoding
  description: From a text to points, and from a point to addresses, places and parcels
- name: autocompletion
  description: Suggestions of addresses and places as a text is typed
- name: csv
  description: Every row of a CSV file geocoded or reverse geocoded, answered as a CSV file
- name: capabilities
  description: What the geocoder and its autocompletion serve, as the documents of the IGN Géoplateforme
paths:
  /search:
    get:
      summary: Geocode a text, an address or a place, into points
      description: Every error of the parameters is answered at once, in `detail`.
      operationId: search
      tags:
      - geocoding
      parameters:
      - in: query
        name: q
        required: true
        description: The text searched, 3 to 200 characters, starting with a letter or a digit
        schema:
          type: string
          example: 8 rue des jardins metz
      - in: query
        name: autocomplete
        description: Whether the last word may be the start of a word, `true` when absent
        schema:
          type: boolean
      - $ref: '#/components/parameters/Index'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Lon'
      - $ref: '#/components/parameters/Lat'
      - $ref: '#/components/parameters/ReturnTrueGeometry'
      - $ref: '#/components/parameters/Postcode'
      - $ref: '#/components/parameters/Citycode'
      - $ref: '#/components/parameters/Depcode'
      - $ref: '#/components/parameters/Type'
      - $ref: '#/components/parameters/City'
      - $ref: '#/components/parameters/Category'
      - $ref: '#/components/parameters/Departmentcode'
      - $ref: '#/components/parameters/Municipalitycode'
      - $ref: '#/components/parameters/Oldmunicipalitycode'
      - $ref: '#/components/parameters/Districtcode'
      - $ref: '#/components/parameters/Section'
      - $ref: '#/components/parameters/Number'
      - $ref: '#/components/parameters/Sheet'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocodeResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
  /reverse:
    get:
      summary: The addresses nearest a point, or within a geometry
      description: Every error of the parameters is answered at once, in `detail`.
      operationId: reverse
      tags:
      - geocoding
      parameters:
      - in: query
        name: searchgeom
        description: A GeoJSON Polygon, or a Circle (`{"type":"Circle","coordinates":[lon,lat],"radius":meters}`, 500 m at most), to search within
        schema:
          type: string
      - $ref: '#/components/parameters/Index'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Lon'
      - $ref: '#/components/parameters/Lat'
      - $ref: '#/components/parameters/ReturnTrueGeometry'
      - $ref: '#/components/parameters/Postcode'
      - $ref: '#/components/parameters/Citycode'
      - $ref: '#/components/parameters/Depcode'
      - $ref: '#/components/parameters/Type'
      - $ref: '#/components/parameters/City'
      - $ref: '#/components/parameters/Category'
      - $ref: '#/components/parameters/Departmentcode'
      - $ref: '#/components/parameters/Municipalitycode'
      - $ref: '#/components/parameters/Oldmunicipalitycode'
      - $ref: '#/components/parameters/Districtcode'
      - $ref: '#/components/parameters/Section'
      - $ref: '#/components/parameters/Number'
      - $ref: '#/components/parameters/Sheet'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocodeResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
  /completion:
    get:
      summary: Suggest addresses and places as a text is typed
      description: |
        The autocompletion of the IGN Géoplateforme: the best suggestions of the address and POI indexes, best score first.
        Every error of the parameters is answered at once, in `detail`.
      operationId: completion
      tags:
      - autocompletion
      parameters:
      - in: query
        name: text
        required: true
        description: The text typed so far, 3 to 200 characters, starting with a letter or a digit
        schema:
          type: string
          example: 8 rue des jard
      - in: query
        name: terr
        description: |
          Comma-separated territories the suggestions must lie in, kept after the search:
          `METROPOLE`, `DOMTOM`, a departement code (`57`, `2A`, `974`) or a postal code
        schema:
          type: string
          example: METROPOLE
      - in: query
        name: poiType
        description: The category of the places suggested, see `getCapabilities`
        schema:
          type: string
          example: administratif
      - in: query
        name: lonlat
        description: '`longitude,latitude` (WGS 84) of a point, the suggestions near it come first'
        schema:
          type: string
          example: 6.17,49.12
      - in: query
        name: type
        description: Comma-separated kinds of suggestions, `PositionOfInterest` and `StreetAddress`, both when absent
        schema:
          type: string
          example: StreetAddress
      - in: query
        name: maximumResponses
        description: The maximum number of suggestions, 1 to 15, 10 when absent
        schema:
          type: integer
          format: uint32
      - in: query
        name: bbox
        description: '`xmin,ymin,xmax,ymax` (WGS 84), the box the suggestions must lie in, kept after the search; its middle acts as `lonlat` when absent'
        schema:
          type: string
          example: 6,49,6.3,49.2
      - $ref: '#/components/parameters/Depcode'
      - in: query
        name: citycode
        description: Comma-separated INSEE codes of communes, 5 digits, 200 at most
        schema:
          type: string
          example: '57463'
      - in: query
        name: zipcode
        description: Comma-separated postal codes, 50 at most
        schema:
          type: string
          example: '57000'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompletionResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
  /search/csv:
    post:
      summary: Geocode every row of a CSV file, from the text of its columns
      description: |
        A CSV file of 50 MiB and 200 000 rows at most, its separator, line ending and encoding guessed, answered as it is geocoded:
        the rows of the file, each followed by the columns of its best result and its `result_status` (`ok`, `not-found`, `skipped`, `error`),
        in `<name>-geocoded.csv`.
        The header `X-Rows-Count` tells the number of rows of the file, counted before the first one is geocoded.
        A file that cannot be read, an unknown column or more than 200 000 rows answer 400, a file over 50 MiB answers 413,
        and a request in the few seconds after a restart may answer 503.
      operationId: search_csv
      tags:
      - csv
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CsvGeocodingForm'
            encoding:
              columns:
                style: form
                explode: true
              indexes:
                style: form
                explode: true
              result_columns:
                style: form
                explode: true
      responses:
        '200':
          description: OK
          headers:
            Content-Disposition:
              description: Content-Disposition
              schema:
                type: string
            X-Rows-Count:
              description: X-Rows-Count
              schema:
                type: integer
                format: uint32
          content:
            text/csv:
              schema:
                type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '413':
          description: Payload Too Large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
  /reverse/csv:
    post:
      summary: The address nearest each row of a CSV file, from its coordinates
      description: |
        A CSV file of 50 MiB and 200 000 rows at most, its separator, line ending and encoding guessed, answered as it is geocoded:
        the rows of the file, each followed by the columns of its best result and its `result_status` (`ok`, `not-found`, `skipped`, `error`),
        in `<name>-geocoded.csv`.
        The header `X-Rows-Count` tells the number of rows of the file, counted before the first one is geocoded.
        A file that cannot be read, an unknown column or more than 200 000 rows answer 400, a file over 50 MiB answers 413,
        and a request in the few seconds after a restart may answer 503.
      operationId: reverse_csv
      tags:
      - csv
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/CsvGeocodingForm'
            encoding:
              columns:
                style: form
                explode: true
              indexes:
                style: form
                explode: true
              result_columns:
                style: form
                explode: true
      responses:
        '200':
          description: OK
          headers:
            Content-Disposition:
              description: Content-Disposition
              schema:
                type: string
            X-Rows-Count:
              description: X-Rows-Count
              schema:
                type: integer
                format: uint32
          content:
            text/csv:
              schema:
                type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '413':
          description: Payload Too Large
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeocoderError'
  /getCapabilities:
    get:
      summary: What the geocoder serves, its operations, parameters and indexes
      description: The document of the IGN Géoplateforme, written for this API, in French as the one of the IGN.
      operationId: get_capabilities
      tags:
      - capabilities
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Capabilities'
  /completion/getCapabilities:
    get:
      summary: What the autocompletion serves, its parameters and kinds of suggestions
      description: The document of the IGN Géoplateforme, written for this API, in French as the one of the IGN.
      operationId: get_completion_capabilities
      tags:
      - capabilities
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Capabilities'
components:
  parameters:
    Index:
      in: query
      name: index
      description: Comma-separated indexes searched, `address`, `poi` and `parcel`, `address` when absent
      schema:
        type: string
        example: address,poi
    Limit:
      in: query
      name: limit
      description: The maximum number of results, 1 to 50, 20 at most with `returntruegeometry`; 10 when absent
      schema:
        type: integer
        format: uint32
    Lon:
      in: query
      name: lon
      description: Longitude (WGS 84) of the point to search around, with `lat`
      schema:
        type: number
        format: double
        example: 6.1757
    Lat:
      in: query
      name: lat
      description: Latitude (WGS 84) of the point to search around, with `lon`
      schema:
        type: number
        format: double
        example: 49.1197
    ReturnTrueGeometry:
      in: query
      name: returntruegeometry
      description: Whether to answer the true geometry of each result in `truegeometry`
      schema:
        type: boolean
    Postcode:
      in: query
      name: postcode
      description: Comma-separated postal codes, 50 at most; addresses and points of interest
      schema:
        type: string
        example: '57000'
    Citycode:
      in: query
      name: citycode
      description: Comma-separated INSEE codes of communes, 200 at most
      schema:
        type: string
        example: '57463'
    Depcode:
      in: query
      name: depcode
      description: Comma-separated departement codes, 10 at most
      schema:
        type: string
        example: '57'
    Type:
      in: query
      name: type
      description: The kind of address, `housenumber`, `street`, `locality` or `municipality`; the points of interest have none
      schema:
        type: string
    Departmentcode:
      in: query
      name: departmentcode
      description: |
        Parcels: the departement of the identifier, `57`, `2A`, `97`; with `index=parcel` and without `q`, a structured search,
        for example `index=parcel&departmentcode=57&municipalitycode=463&section=24&number=0142`
      schema:
        type: string
    Municipalitycode:
      in: query
      name: municipalitycode
      description: 'Parcels: the commune, 2 or 3 digits, `463` for Metz'
      schema:
        type: string
    Oldmunicipalitycode:
      in: query
      name: oldmunicipalitycode
      description: 'Parcels: the former commune, 3 digits, `000` for none'
      schema:
        type: string
    Districtcode:
      in: query
      name: districtcode
      description: 'Parcels: the arrondissement of Paris, Lyon or Marseille, 3 digits, `000` for none'
      schema:
        type: string
    Section:
      in: query
      name: section
      description: 'Parcels: the section, 1 or 2 digits or capital letters'
      schema:
        type: string
    Number:
      in: query
      name: number
      description: 'Parcels: the number in the section, 1 to 4 digits'
      schema:
        type: string
    Sheet:
      in: query
      name: sheet
      description: 'Parcels: the sheet, 1 or 2 digits'
      schema:
        type: string
    Category:
      in: query
      name: category
      description: Comma-separated categories of the points of interest, 10 at most, see `getCapabilities`, for example `administratif`; the addresses have none
      schema:
        type: string
    City:
      in: query
      name: city
      description: The name of a commune, 50 characters at most, for example `Metz`, instead of `citycode`
      schema:
        type: string
  schemas:
    GeocoderError:
      type: object
      required:
      - code
      - message
      properties:
        code:
          description: The HTTP status
          type: integer
          format: uint16
        message:
          type: string
          example: Failed parsing query
        detail:
          description: 'One `param: message` per invalid parameter'
          type: array
          items:
            type: string
    GeocodeResponse:
      type: object
      required:
      - type
      - features
      properties:
        type:
          description: '`FeatureCollection`'
          type: string
        features:
          type: array
          items:
            $ref: '#/components/schemas/GeocodeFeature'
        query:
          description: The text searched, `/search` only
          type: string
    GeocodeFeature:
      description: An address, a point of interest or a parcel, told apart by `properties._type`
      oneOf:
      - $ref: '#/components/schemas/AddressFeature'
      - $ref: '#/components/schemas/PoiFeature'
      - $ref: '#/components/schemas/ParcelFeature'
    AddressFeature:
      type: object
      required:
      - type
      - geometry
      - properties
      properties:
        type:
          description: '`Feature`'
          type: string
        geometry:
          $ref: '#/components/schemas/PointGeometry'
        properties:
          $ref: '#/components/schemas/AddressProperties'
    PointGeometry:
      type: object
      required:
      - type
      - coordinates
      properties:
        type:
          description: '`Point`'
          type: string
        coordinates:
          description: '`[longitude, latitude]`, WGS 84'
          type: array
          items:
            type: number
            format: double
    AddressProperties:
      type: object
      required:
      - label
      properties:
        label:
          type: string
          example: 8 Rue de la Paix 57000 Metz
        score:
          description: How well the result matches, 0 to 1
          type: number
          format: double
          example: 0.97
        housenumber:
          type: string
          example: '8'
        id:
          type: string
        banId:
          type: string
        name:
          type: string
          example: 8 Rue de la Paix
        postcode:
          type: string
          example: '57000'
        citycode:
          description: The INSEE code of the commune
          type: string
          example: '57463'
        x:
          description: Lambert 93 easting
          type: number
          format: double
        y:
          description: Lambert 93 northing
          type: number
          format: double
        city:
          type: string
          example: Metz
        district:
          type: string
        oldcitycode:
          type: string
        oldcity:
          type: string
        context:
          description: The departement number, the departement and the region
          type: string
          example: 57, Moselle, Grand Est
        type:
          description: '`housenumber`, `street`, `locality` or `municipality`'
          type: string
          example: housenumber
        importance:
          type: number
          format: double
        population:
          type: integer
          format: uint64
        depcode:
          type: string
        street:
          type: string
        locality:
          type: string
        municipality:
          type: string
        truegeometry:
          description: The true geometry, a GeoJSON text, with `returntruegeometry`
          type: string
        distance:
          description: In meters from the point of `/reverse`
          type: integer
          format: uint32
        _type:
          description: The index of the result, `address`
          type: string
    CompletionResponse:
      type: object
      required:
      - status
      - results
      properties:
        status:
          description: '`OK`: an index that is not available answers 503 instead of the `Error` status of the IGN service'
          type: string
        results:
          type: array
          items:
            $ref: '#/components/schemas/Suggestion'
    Suggestion:
      description: An address (`StreetAddress`) or a place (`PositionOfInterest`), each with its own fields
      type: object
      required:
      - x
      - y
      - country
      properties:
        x:
          description: Longitude, WGS 84
          type: number
          format: double
        y:
          description: Latitude, WGS 84
          type: number
          format: double
        country:
          description: '`StreetAddress` or `PositionOfInterest`'
          type: string
        city:
          type: string
        oldcity:
          description: The former commune of an address, empty when none
          type: string
        kind:
          description: The kind of an address (`housenumber`, `street`, `locality`, `municipality`), the first category of a place
          type: string
        zipcode:
          type: string
        zipcodes:
          description: Every postal code of a place
          type: array
          items:
            type: string
        names:
          description: The names of a place
          type: array
          items:
            type: string
        poiType:
          description: The categories of a place
          type: array
          items:
            type: string
        street:
          type: string
        metropole:
          description: Whether it lies in metropolitan France
          type: boolean
        fulltext:
          description: The text of the suggestion, `name, postcode city`
          type: string
          example: 8 Rue des Jardins, 57000 Metz
        classification:
          description: The importance of a place, 7 for an address
          type: integer
          format: uint32
    Capabilities:
      type: object
      required:
      - info
      - api
      - operations
      - indexes
      properties:
        info:
          $ref: '#/components/schemas/CapabilitiesInfo'
        api:
          $ref: '#/components/schemas/CapabilitiesApi'
        operations:
          type: array
          items:
            $ref: '#/components/schemas/CapabilitiesOperation'
        indexes:
          type: array
          items:
            $ref: '#/components/schemas/CapabilitiesIndex'
    CapabilitiesInfo:
      type: object
      required:
      - name
      - title
      - description
      - language
      - contact
      properties:
        name:
          type: string
        title:
          type: string
        description:
          type: string
        language:
          type: string
        contact:
          $ref: '#/components/schemas/CapabilitiesContact'
    CapabilitiesContact:
      type: object
      required:
      - email
      properties:
        email:
          type: string
    CapabilitiesApi:
      type: object
      required:
      - name
      - version
      properties:
        name:
          description: '`rest`'
          type: string
        version:
          type: string
    CapabilitiesOperation:
      type: object
      required:
      - id
      - description
      - url
      - methods
      - parameters
      properties:
        id:
          type: string
        description:
          type: string
        url:
          description: Relative to the root of the API
          type: string
        methods:
          type: array
          items:
            type: string
        parameters:
          type: array
          items:
            $ref: '#/components/schemas/CapabilitiesParameter'
    CapabilitiesParameter:
      type: object
      required:
      - name
      - in
      - description
      - required
      - schema
      properties:
        name:
          type: string
        in:
          description: '`query`'
          type: string
        description:
          type: string
        required:
          type: boolean
        schema:
          $ref: '#/components/schemas/CapabilitiesParameterSchema'
    CapabilitiesParameterSchema:
      type: object
      required:
      - type
      - example
      properties:
        type:
          type: string
        example:
          type: string
        enum:
          type: array
          items:
            type: string
    CapabilitiesIndex:
      type: object
      required:
      - id
      - description
      - fields
      properties:
        id:
          type: string
        description:
          type: string
        fields:
          type: array
          items:
            $ref: '#/components/schemas/CapabilitiesField'
    CapabilitiesField:
      type: object
      required:
      - name
      - description
      - type
      - queryable
      - filter
      properties:
        name:
          type: string
        description:
          type: string
        type:
          type: string
        queryable:
          description: Whether the text searched is looked for in this field
          type: boolean
        filter:
          description: Whether the field is a filter parameter
          type: boolean
        values:
          description: |
            The values the field takes, when they are few: a list, or for the category of the points of interest
            each main category with its subcategories (`{"administratif": ["commune", "epci", …], …}`), as the index holds them
          $ref: '#/components/schemas/AnyJson'
    CsvGeocodingForm:
      description: |
        The file, and the names of its columns that the search reads.
        Each filter (`citycode`, `postcode`, `type`, `category`, `lon`, `lat`, `departmentcode`, `municipalitycode`, `oldmunicipalitycode`,
        `districtcode`, `section`, `sheet`, `number`) names the column that holds it; the coordinates are found in `latitude` / `lat` and
        `longitude` / `lon` / `lng` / `long` when not named.
      type: object
      required:
      - data
      properties:
        data:
          type: string
          format: binary
        columns:
          description: The columns whose values, joined by a space, are searched; every column when absent
          type: array
          items:
            type: string
        indexes:
          description: The indexes searched, `address` when absent
          type: array
          items:
            type: string
        result_columns:
          description: The result columns written, in their order; every column of the indexes when absent
          type: array
          items:
            type: string
    PoiFeature:
      description: A point of interest of the BD TOPO
      type: object
      required:
      - type
      - geometry
      - properties
      properties:
        type:
          description: '`Feature`'
          type: string
        geometry:
          $ref: '#/components/schemas/PointGeometry'
        properties:
          $ref: '#/components/schemas/PoiProperties'
    PoiProperties:
      type: object
      required:
      - name
      - toponym
      - category
      - extrafields
      - classification
      - territory
      properties:
        name:
          type: array
          items:
            type: string
        toponym:
          type: string
        category:
          description: The categories of the point, the most precise first, see `getCapabilities`
          type: array
          items:
            type: string
        postcode:
          type: array
          items:
            type: string
        citycode:
          type: array
          items:
            type: string
        depcode:
          type: array
          items:
            type: string
        city:
          type: array
          items:
            type: string
        extrafields:
          description: Per kind of point (`population`, `nature_detaillee`…), always `cleabs`, the identifier of the BD TOPO
          $ref: '#/components/schemas/AnyJson'
        classification:
          description: The importance of the point, 1 (the most important) to 7
          type: integer
          format: uint32
        territory:
          description: '`METROPOLE` or `DOMTOM`'
          type: string
        importance:
          description: '`/reverse` only'
          type: number
          format: double
        score:
          type: number
          format: double
        distance:
          description: In meters from the point of `/reverse`
          type: integer
          format: uint32
        truegeometry:
          description: With `returntruegeometry`, a GeoJSON text in `/search` and a GeoJSON object in `/reverse`, as the IGN service answers it
          $ref: '#/components/schemas/AnyJson'
        _type:
          description: '`poi`'
          type: string
    ParcelFeature:
      description: A cadastral parcel of the Parcellaire Express, its point the centroid of the parcel
      type: object
      required:
      - type
      - geometry
      - properties
      properties:
        type:
          description: '`Feature`'
          type: string
        geometry:
          $ref: '#/components/schemas/PointGeometry'
        properties:
          $ref: '#/components/schemas/ParcelProperties'
    ParcelProperties:
      type: object
      required:
      - id
      properties:
        id:
          description: The identifier (IDU), its codes joined
          type: string
          example: '57463000240142'
        departmentcode:
          type: string
        municipalitycode:
          type: string
        oldmunicipalitycode:
          type: string
        districtcode:
          type: string
        section:
          type: string
        sheet:
          type: string
        number:
          type: string
        city:
          description: The name of the commune
          type: string
        distance:
          description: In meters from the given point, always in `/reverse`
          type: integer
          format: uint32
        score:
          type: number
          format: double
        truegeometry:
          description: With `returntruegeometry`, the GeoJSON object of the parcel
          $ref: '#/components/schemas/AnyJson'
        _type:
          description: '`parcel`'
          type: string
    AnyJson:
      description: Any JSON value
