{"id":"c9e94aed-3340-4824-9e94-ea919471f546","type":"API","name":"API Géoplateforme - Autocomplétion","slug":"api-geoplateforme-autocompletion","description":"L'API d'autocomplétion de la Géoplateforme a pour but de suggérer des localisants probables, au fur et à mesure de la saisie d’adresses ou de noms de lieux. Son usage est limité à 10 requêtes par seconde depuis une même adresse IP. Elle s'appuie sur des données BAN, BD TOPO® et Parcellaire Expres…","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.data.gouv.fr/dataservices/api-geoplateforme-autocompletion","docs_url":"https://geoservices.ign.fr/documentation/services/services-geoplateforme/autocompletion","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["land"],"logo_url":"https://udata-avatars.s3.rbx.io.cloud.ovh.net/81/98295ded66449e80a960b8bc20e527-100.jpg","primary_source_url":"https://www.data.gouv.fr/dataservices/api-geoplateforme-autocompletion","extraction_confidence":"0.40","created_at":"2026-06-07T22:08:48.605Z","updated_at":"2026-08-20T00:00:36.255Z","last_verified_at":"2026-08-19T20:50:43.406Z","deprecated_at":null,"ranking_score":58,"last_ranked_at":"2026-08-08T19:19:23.085Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'10':42B,119B,186B,264B 'a':158B,169B,185B,232B 'access':109B,254B 'address':77B,125B,142B,222B,270B,287B 'adress':31B,49B,96B 'adresse':193B,241B 'adresses':175B 'and':223B,245B,279B 'api':1A,5A,8B,64B,145A,149A,152B,209B 'appui':53B 'appuie':197B 'as':231B 'au':22B,166B 'authent':113B 'authentication':258B 'autocomplet':6A,82B 'autocompletion':147A,150A,154B,227B 'autocomplét':3A,10B 'ban':57B,94B,201B,239B 'base':95B,240B 'bd':58B,98B,202B,243B 'but':160B,259B 'cover':107B 'covering':252B 'd':9B,30B,153B,174B 'dataset':103B 'datasets':248B 'de':11B,17B,27B,33B,35B,69B,155B,161B,171B,177B,179B,214B 'depui':46B 'depuis':190B 'des':19B,55B,163B,199B 'donnees':200B 'donné':56B 'ell':51B 'elle':195B 'est':39B,183B 'et':24B,60B,73B,168B,205B,218B 'expr':62B 'expres':207B 'express':102B,247B 'field':133B 'fields':278B 'for':274B 'forestiere':219B 'forestièr':74B 'franc':108B 'france':253B 'free':111B,256B 'from':210B 'fur':23B,167B 'generat':105B 'generate':250B 'geographique':217B 'geoloc':135B 'geolocation':280B 'geoplateforme':146A,148A,157B 'géographiqu':72B 'géoplateform':2A,4A,13B 'ign':75B,220B 'increment':139B 'incremental':284B 'inform':71B 'information':216B 'institut':67B,212B 'integr':130B 'integration':275B 'intend':128B 'intended':273B 'into':276B 'ip':50B,124B,194B,269B 'is':255B,261B,272B 'it':235B,271B 'l':7B,70B,151B,215B 'la':12B,28B,156B,172B 'land':144C 'lieux':36B,180B 'like':84B 'likely':229B 'limit':117B 'limite':184B 'limited':262B 'limité':40B 'localis':20B 'localisants':164B 'locat':85B 'locations':230B 'match':143B 'matching':288B 'meme':192B 'mesur':26B 'mesure':170B 'même':48B 'name':81B,226B 'nation':68B 'national':97B,213B 'nationale':242B 'nom':34B 'noms':178B 'on':237B 'or':286B 'ou':32B,176B 'par':44B,188B 'parcellair':61B,101B 'parcellaire':206B,246B 'per':121B,123B,266B,268B 'place':80B,140B,225B,285B 'place-nam':79B 'place-name':224B 'pour':15B,159B 'probabl':21B 'probables':165B 'provid':76B 'provides':221B 'quick':138B,283B 'r':204B 'reli':91B 'relies':236B 'request':120B 'requests':265B 'requetes':187B 'requir':137B 'requiring':282B 'requêt':43B 's':196B 'saisi':29B 'saisie':173B 'search':132B,277B 'second':45B,122B,267B 'seconde':189B 'son':37B,181B 'suggerer':162B 'suggest':83B,106B 'suggesting':228B 'suggestions':251B 'suggérer':18B 'sur':54B,198B 'the':211B,238B 'this':208B 'to':249B,263B 'tool':136B 'tools':281B 'topo':59B,99B,203B,244B 'type':89B 'types':234B 'une':47B,191B 'usag':38B,115B 'usage':182B,260B 'user':88B,233B 'without':112B,257B 'à':25B,41B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"d2456681-4772-4941-a900-eb1f8ec29948","institution_type":"AGENCY","country_code":"FR","official_confidence":40,"proof_summary":"official domain (data.gouv.fr) (catalog: api_gouv_fr)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-06-07T22:08:48.605Z","geographic_scope":"NATIONAL","name_en":"Géoplateforme API - Autocompletion","description_en":"This API from the Institut national de l'information géographique et forestière (IGN) provides address and place-name autocompletion, suggesting likely locations as a user types. It relies on the BAN (Base Adresse Nationale), BD TOPO, and Parcellaire Express datasets to generate suggestions covering France. Access is free without authentication, but usage is limited to 10 requests per second per IP address. It is intended for integration into search fields and geolocation tools requiring quick, incremental place or address matching.","native_lang":"fr","access_level":"documented","formats":[],"capability_tier":"sample","trust_score":71.25,"access":{"level":"documented","primary":{"kind":"query","label":"Run verified request","method":"GET","url":"https://data.geopf.fr/geocodage/completion/openapi.yaml","source":"probe","runnable":true},"actions":[{"kind":"query","label":"Run verified request","method":"GET","url":"https://data.geopf.fr/geocodage/completion/openapi.yaml","source":"probe","runnable":true},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://geoservices.ign.fr/documentation/services/services-geoplateforme/autocompletion","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.data.gouv.fr/dataservices/api-geoplateforme-autocompletion","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"c9e94aed-3340-4824-9e94-ea919471f546","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"profiled","level_index":3,"level_label":"Profiled","meaning":"Schema, dimensions and licence understood","counts_as_coverage":false,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":true,"reached":true,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":false,"reached":false,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":40,"proven_threshold":80,"institution_id":"d2456681-4772-4941-a900-eb1f8ec29948","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"www.data.gouv.fr","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-08-22T20:49:44.882Z"},"api_details":{"id":"ad311fa2-5c53-4e0a-b3dc-0a8382209afe","entry_id":"c9e94aed-3340-4824-9e94-ea919471f546","base_url":null,"openapi_url":"https://data.geopf.fr/geocodage/completion/openapi.yaml","graphql_url":null,"api_version":null,"spec_format":"openapi","endpoints_count":null,"endpoints":[],"rate_limit_info":null,"free_tier_limits":null,"ping_url":null,"created_at":"2026-06-07T22:08:48.627Z","updated_at":"2026-06-07T22:08:48.627Z"},"dataset_details":null,"license":{"id":"lo-2.0","spdx_id":"etalab-2.0","name":"Licence Ouverte 2.0 (France / Etalab)","url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","is_open":true,"is_redistributable":true,"requires_attribution":true,"category":"national","notes":null,"created_at":"2026-06-12T16:29:19.729Z"},"reuse":{"license_id":"lo-2.0","license_name":"Licence Ouverte 2.0 (France / Etalab)","license_url":"https://www.etalab.gouv.fr/wp-content/uploads/2017/04/ETALAB-Licence-Ouverte-v2.0.pdf","commercial_use":{"status":"yes","value":true},"redistribution":{"status":"yes","value":true},"attribution_required":{"status":"yes","value":true},"share_alike":{"status":"no","value":false},"personal_data_warning":{"status":"yes","value":true},"cache_and_mirror":{"status":"yes","value":true},"undetermined":[],"basis":"licence_text","confidence":0.95,"confidence_tier":"high","source_text":"Texte de la licence - le reutilisateur est libre \"de la communiquer, la reproduire, la copier ; de l'adapter, la modifier, l'extraire et la transformer, notamment pour creer des Informations derivees ; de la diffuser, la redistribuer, la publier et la transmettre, de l'exploiter a titre commercial\". Seule obligation : \"mentionner la paternite de l'Information : sa source (a minima le nom du Concedant) et la date de la derniere mise a jour\". Le texte rappelle que le reutilisateur doit respecter \"le cadre legal relatif a la protection des donnees a caractere personnel\". Aucune clause de partage a l'identique n'est imposee.","source_url":"https://github.com/etalab/licence-ouverte/blob/master/LO.md","reviewed_at":null},"license_raw":"https://www.etalab.gouv.fr/licence-ouverte-open-licence","latest_check":{"id":"2ff9ce83-21dd-4977-8f8a-bbf8130c3606","entry_id":"c9e94aed-3340-4824-9e94-ea919471f546","status":"VERIFIED","last_checked_at":"2026-08-19T20:50:43.087Z","p50_latency_ms":2311,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:43:16.541Z","updated_at":"2026-08-19T20:50:43.087Z","consecutive_successes":13,"probe_url":"https://data.geopf.fr/geocodage/completion/openapi.yaml","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/yaml; charset=utf-8","probe_succeeded_at":"2026-08-19T20:50:43.087Z"},"data_profile":{"id":"729d14ef-ae16-42f8-89e8-80dd0369f660","entry_id":"c9e94aed-3340-4824-9e94-ea919471f546","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"text","role":"parameter","type":"string","label":null,"param_in":"query","required":true,"container":"/","filterable":true,"description":"Le texte devant être completé","description_en":"Text string to autocomplete."},{"name":"terr","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Une limitation de la zone de recherche de localisants. Une liste peut être fournie en séparant les valeurs par des virgules. Les valeurs acceptées sont METROPOLE, DOMTOM, code(s) INSEE de département, code(s) postaux de commune.","description_en":"Restricts search to a territory: METROPOLE, DOMTOM, or department/postal codes."},{"name":"poiType","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Filtre sur le type de localisant pour le type POI.\nLes valeurs possibles sont listées dans le getCapabilities du service d'autocompletion.\n","description_en":"Filters results by POI type, as listed in getCapabilities."},{"name":"depcode","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Filtre pour les index address et poi. Il permet de filtrer les résultats par code départmeent. Accepte plusieurs valeurs séparées par des virgules (maximum 10).","description_en":"Filters address/POI results by department code(s), comma-separated, max 10."},{"name":"zipcode","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Filtre pour les index address et poi. Il permet de filtrer les résultats par code postal. Accepte plusieurs valeurs séparées par des virgules (maximum 50).","description_en":"Filters address/POI results by postal code(s), comma-separated, max 50."},{"name":"citycode","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Filtre pour les index address et poi. Il permet de filtrer les résultats par code INSEE. Accepte plusieurs valeurs séparées par des virgules (maximum 200).","description_en":"Filters address/POI results by INSEE code(s), comma-separated, max 200."},{"name":"lonlat","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"coordonnées (longitude,latitude) d'un localisant pour favoriser les candidats les plus proches.","description_en":"Reference coordinates (longitude,latitude) to prioritize nearby results."},{"name":"type","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Le type de localisants recherchés.\nIl est possible de spécifier plusieurs types séparés par une virgule.\n","enum_values":["PositionOfInterest","StreetAddress","PositionOfInterest,StreetAddress"],"description_en":"Type(s) of locations sought, comma-separated if multiple."},{"name":"maximumResponses","role":"parameter","type":"integer","label":null,"param_in":"query","container":"/","filterable":true,"description":"Le nombre maximum de réponses que l’on souhaite voir retournées (entre 1 et 15)","description_en":"Maximum number of results to return, between 1 and 15."},{"name":"bbox","role":"parameter","type":"string","label":null,"param_in":"query","container":"/","filterable":true,"description":"Filtre avec une bbox suivant l'ordre xmin,ymin,xmax,ymax","description_en":"Bounding box filter in order xmin,ymin,xmax,ymax."},{"name":"info","type":"object","label":"Getcapabilities","description":null,"description_en":"General information section of the service capabilities."},{"name":"api","type":"object","label":"Getcapabilities","description":null,"description_en":"API metadata section of the service capabilities."},{"name":"operations","type":"array<object>","label":"Getcapabilities","description":null,"description_en":"List of operations supported by the autocompletion service."},{"name":"indexes","type":"array<object>","label":"Getcapabilities","description":null,"description_en":"List of data indexes available for autocompletion queries."},{"name":"country","type":"string","label":"Address","required":true,"description":null,"description_en":"Country of the matched address."},{"name":"city","type":"string","label":"Address","required":true,"description":null,"description_en":"City name of the matched address."},{"name":"x","type":"number (float)","label":"Address","format":"float","required":true,"description":null,"description_en":"X coordinate (longitude) of the matched location."},{"name":"y","type":"number (float)","label":"Address","format":"float","required":true,"description":null,"description_en":"Y coordinate (latitude) of the matched location."},{"name":"street","type":"string","label":"Address","required":true,"description":null,"description_en":"Street name of the matched address."},{"name":"classification","type":"integer (int32)","label":"Address","format":"int32","required":true,"description":null,"description_en":"Numeric classification code assigned to the address result."},{"name":"kind","type":"string","label":"Address","required":true,"description":null,"description_en":"Kind or category of the matched address."},{"name":"fulltext","type":"string","label":"Address","required":true,"description":null,"description_en":"Full text representation of the matched address."},{"name":"metropole","type":"boolean","label":"Address","required":true,"description":null,"description_en":"Indicates whether the address is in metropolitan France."},{"name":"zipcodes","type":"array<string>","label":"Poi","required":true,"description":null,"description_en":"List of postal codes associated with the point of interest."},{"name":"status","type":"string","label":"Response","required":true,"description":null,"description_en":"Status of the API response."},{"name":"results","type":"array<unknown>","label":"Response","required":true,"description":null,"description_en":"List of matching results returned by the query."}],"field_count":26,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://data.geopf.fr/geocodage/completion/openapi.yaml","curl":"curl -s 'https://data.geopf.fr/geocodage/completion/openapi.yaml' -H 'Accept: application/json'","label":"OpenAPI spec","method":"GET","description":"Machine-readable API description (use it to generate clients)."}],"status":"partial","error_message":null,"profiled_at":"2026-07-22T00:06:36.775Z","run_id":"4d958478-3021-4326-9353-29cc71367e88","created_at":"2026-06-12T19:02:59.640Z","updated_at":"2026-07-22T00:06:36.775Z","license_raw":"https://www.etalab.gouv.fr/licence-ouverte-open-licence","license_id":"lo-2.0","consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":false},"datasets":[],"limits":[],"manifest":{"answer_sha256":"ca4e115bf79fd955a595f9fe69fcb9df4966001b9675d3e359e1fd39dd726c3d","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":37,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (26 rows).","live":true,"live_basis":"This body was produced by executing the request.","created_at":"2026-08-22T20:49:45.027Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}