professionnels_rpps_in_radius
Search all types of healthcare professionals (liberal, salaried, hospital, replacements) within a radius using RPPS data. Filter by profession, specialty, and practice mode.
Instructions
Recherche de professionnels de santé dans un rayon via le RPPS (Annuaire Santé ANS). À la différence de professionnels_in_radius (Ameli, libéraux conventionnés uniquement), cette recherche couvre tous les PS : libéraux, salariés (hospitaliers, salariés en cabinet), mixtes, remplaçants. Filtres : profession_codes (nomenclature ANS — ex: 10 Médecin, 60 Infirmier), savoir_faire_codes (spécialité fine DES/DESC), mode_exercice_codes. Codes mode_exercice ANS : L libéral, S salarié, M mixte, R remplaçant, B bénévole, A autre. Par défaut, ne renvoie que les PS de catégorie Civil (C) — droit privé : libéraux, salariés privés, hospitaliers contractuels, ~97 % de la base. Passer include_agents_publics: true pour inclure aussi les Agents publics (M) — fonctionnaires d'État + collectivités + militaires SSA, ~0,3 % (PH titulaires, médecins inspecteurs ARS, médecins conseils CNAM, médecins scolaires Éducation nationale, médecins PMI). Passer include_etudiants: true pour inclure aussi les Étudiants (E) — internes, externes, élèves IDE/SF, ~2,5 %. Source nomenclature : https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/. Coords au centroïde commune (~3 km moyenne) — pour précision adresse, croiser num_finess retourné avec etablissement_by_finess. Source : Annuaire Santé, Agence du Numérique en Santé (ANS) — Licence Ouverte v2.0
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| center | Yes | Centre du cercle de recherche (coordonnées WGS84). | |
| radius_km | Yes | Rayon en km (0.1-50). | |
| profession_codes | No | Codes profession ANS (ex: ['10'] Médecin, ['60'] Infirmier). Si omis, toutes professions. | |
| savoir_faire_codes | No | Codes savoir-faire ANS (spécialités fines DES/DESC). Si omis, tous savoir-faire. | |
| mode_exercice_codes | No | Codes mode d'exercice ANS (libéral / salarié / mixte). Si omis, tous modes. | |
| include_etudiants | No | ||
| include_agents_publics | No | ||
| limit | No | Nombre max de résultats retournés (défaut serveur 100). | |
| include_freshness | No | Si true, ajoute un champ `data_freshness` au payload (dans `query_metadata` si présent, sinon à la racine) listant la dernière ingestion réussie par source (FINESS, Ameli, RPPS) avec `staleness_days`. Opt-in pour ne pas alourdir les payloads par défaut. Cache 5min côté serveur — coût négligeable. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | Nombre d'entrées retournées dans `results` (post-troncature). | |
| truncated | No | true si le total réel dépasse `limit` (re-paginer via `offset` si supporté). Optional sur les tools de listing exhaustif (lister_*). | |
| results | Yes | Entrées métier (shape spécifique au tool, cf. description du tool). | |
| query_metadata | No | Metadata de la query (radius_km, departement, filtres appliqués, …). | |
| freshness | No | Fraîcheur des sources (présent si `include_freshness: true`). |