💡 L'API Addok : est intégrée dans la plateforme. Elle s'orchestre avec un job Dasgter mensuel. Le déploiement est paramétrable et cette fiche vous permet d'être autonome sur celui-ci.
L'intégration d'Addok à la plate-forme peut être activée en mettant le feature flag correspondant dans les values du fichier argocd/apps/arkhn-platform :
addok:
enabled: true
Une fois Addok installé sur la plate-forme, il est possible de faire appel à l'API Addok via son adresse :
curl http://arkhn-platform-addok/search?q=18+boulevard+adolphe+pinard+parsi | jq
{
"type": "FeatureCollection",
"version": "draft",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
2.301961,
48.825119
]
},
"properties": {
"label": "Boulevard Adolphe Pinard 75014 Paris",
"score": 0.7016717112299464,
"id": "75114_0069",
"name": "Boulevard Adolphe Pinard",
"postcode": "75014",
"citycode": "75114",
"x": 648751.99,
"y": 6858566.33,
"city": "Paris",
"district": "Paris 14e Arrondissement",
"context": "75, Paris, Île-de-France",
"type": "street",
"importance": 0.57133
}
}
],
"attribution": "BAN",
"licence": "ETALAB-2.0",
"query": "18 boulevard adolphe pinard parsi",
"limit": 5
}
</details>
## 2. Workflow des données de Géolocalisation
Afin d'enrichir les données de localisation (i.e., les adresses), nous ajoutons en sortie de pivot un job Dagster qui effectue les appels API pour les adresses intégrées :
Le job Dagster est séparé du run_all (ne créant, ainsi, pas de boucle infinie).
## 3. Activation du job Dagster
Pour obtenir l'orchestration mensuelle des données géolocs sur vos adresses, vous devez ajouter une variable Dagster `GEOLOC_ACTIVATED` et lui attribuer la valeur `true`. Ce paramètre doit être stocké dans le secret `dagster-datasources` en suivant la procédure [Gestion des Secrets / PKI](/fr/administration/secrets-management-pki).
Ainsi, dans dagster, vous devrez voir apparaitre le job `geoloc` :
Lorsqu'il tourne, le job crée une table `geoloc.geoloc_ingest_location`.
> **💡** Note : lors du premier lancement, ce job peut prendre un certain temps car aucune adresse n'a été appariée. Cependant lors des runs suivants, le job ne lancera que les nouvelles adresses.
Vous avez la possibilité de choisir le crontab : `GEOLOC_SCHEDULE_CRONTAB`
### Critères de correspondance
Sont pris en compte les colonnes de la variable `GEOLOC_PVT_LOCATION_COLUMNS` de **dbt_pivot.pvt_location** qui, par défault, vaut `address_1,address_2,city,zip.`
## 3. Ajout de la géoloc dans pivot
*work in progress*