31:T631,Un exercice pour illustrer la simplicité d'usage des fonds de carte du projet [`cartiflette`](https://github.com/InseeFrLab/cartiflette) Un grand merci à [Thomas Ansart](https://observablehq.com/@tombor) pour l'aide apportée sur la visualisation des cartes depuis `Observable`

${fas`exclamation-triangle`} Hint

Le projet s'enrichit progressivement de fonctionnalités, n'hésitez pas à __consulter régulièrement cette page__.

Pour le moment, [`cartiflette`](https://github.com/InseeFrLab/cartiflette) est fourni principalement sous forme de _package_ `Python` ${fab`python`}. Quelques fonctionnalités sont portées en `JavaScript` ${fab`js-square`} avec le présent _notebook_.

Le développement d'une API pour offrir de la flexibilité dans la récupération des fichiers tout en laissant la liberté à l'utilisateur est prévue. N'hésitez pas à proposer de l'aide sur [`Github` ${fab`github`} `inseefrlab/cartiflette`](https://github.com/InseeFrLab/cartiflette)

32:T583,prez_package = md` ## Principe du package
L'objectif de [\`cartiflette\`](https://github.com/InseeFrLab/cartiflette) est de faciliter la récupération de fonds de carte officiels pour faciliter le travail des cartographes qui désirent associer leurs données à des fonds de carte administratifs. Le projet a été initié dans le cadre du [Programme interministériel 10%](https://10pourcent.etalab.studio/projets/insee/) qui vise à favoriser les échanges entre _data scientists_ de l'administration française. ## Récupérer des données France entière
Les premières données qu'il est possible de récupérer avec le package \`cartiflette\` sont des données France entière. Ce n'est pas là où le package apporte le plus de fonctionnalités novatrices mais cela peut être pratique pour récupérer facilement les contours administratifs (voir 👇 pour ceux disponibles). Il existe deux approches pour cela: 1. Utiliser la fonction \`get_vectorfile_ign\` qui va récupérer directement les données depuis [le site de l'IGN](https://geoservices.ign.fr/adminexpress). Comme il est nécessaire de télécharger les données France entière pour cela et que le format utilisé est le _shapefile_, les données sont volumineuses (de l'ordre de 500Mo). Cela peut donc demander un certain temps ; 2. Utiliser l'une des fonctions de \`cartiflette\`. Ce cas est démontré ci-dessous `33:T881,grid = width > 500 ? html`

${viewof year}

${viewof selectedlevel}

${viewof format}

${viewof simplification_percent}

${viewof drom_rapproches}

${map_france}

${button_france}

Comment faire en ${langage} ${logo[langage.toLowerCase()]} ${print_program_france(langage, selectedlevel, format, year, drom_rapproches, simplification_percent)}

` : html`

${viewof year}

${viewof selectedlevel}

${viewof format}

${map_france}

${button_france}

${print_program_france(langage, selectedlevel, format, year, drom_rapproches, simplification_percent)}

`; 34:T684,// Source: https://observablehq.com/@mbostock/dashboard grid_departement = width > 500 ? html`

${viewof departement}

${viewof arrondissement}

${viewof simplification_percent_departement}

${button_departement}

${map_departement}

` : html`

${viewof departement}

${viewof arrondissement}

${map_departement}

${button_departement}

` 35:T568,// Source: https://observablehq.com/@mbostock/dashboard grid_multiple_departement = width > 500 ? html`

${viewof multiple_departements}

${viewof arrondissement}

${map_multiple_departement}

` : html`

${viewof multiple_departements}

${viewof arrondissement}

${map_multiple_departement}

` 36:[] 2f:{"title":"Cartes de France avec cartiflette 🧀 ","cells":[{"id":219,"value":"md`# Cartes de France avec [\\`cartiflette\\`](https://github.com/InseeFrLab/cartiflette) 🧀

\n${button}`","pinned":false,"hidden":false,"mode":"ojs"},{"id":0,"value":"$31","pinned":false,"hidden":false,"mode":"md"},{"id":252,"value":"$32","pinned":false,"hidden":false,"mode":"ojs"},{"id":31,"value":"html`${button}`","pinned":false,"hidden":false,"mode":"ojs"},{"id":305,"value":"viewof langage_requete = Inputs.radio(\n [\"Python\", \"Javascript\" ,\"R\"], {label: \"Langage de programmation pour les exemples de code\"},\n {value: null, format: x => x ?? \"Python\"}\n)","pinned":false,"hidden":false,"mode":"ojs"},{"id":206,"value":"$33","pinned":false,"hidden":false,"mode":"ojs"},{"id":549,"value":"hint_title_1 = html` Comment faire en ${langage} ${logo[langage.toLowerCase()]} ?`","pinned":false,"hidden":false,"mode":"ojs"},{"id":1121,"value":"html`\n${print_program_france(langage, selectedlevel, format, year, drom_rapproches, simplification_percent)}\n`","pinned":false,"hidden":false,"mode":"ojs"},{"id":69,"value":"partie_2 = md`\n----\n\n## Se restreindre à une zone d'intérêt\n\nL'intérêt principal du projet \\`cartiflette\\` est la mise à disposition facilitée de fonds de carte adaptés aux besoins du _data scientist_ ou du géomaticien. En premier lieu, il est aisé de récupérer directement un niveau géographique donné (ici toutes les communes du département ${departement})\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":293,"value":"$34","pinned":true,"hidden":false,"mode":"ojs"},{"id":663,"value":"viewof arrondissement = Inputs.toggle({label: \"Arrondissement dans les grandes villes ?\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":681,"value":"md`${hint_title}`","pinned":true,"hidden":false,"mode":"ojs"},{"id":1172,"value":" import {download_from_cartiflette} from \"@linogaliana/cartiflette-js\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":1170,"value":"download_from_cartiflette({\n \"value\": \"31\",\n \"borders\": \"COMMUNE\",\n \"vectorfileFormat\": \"topojson\",\n \"year\": 2022,\n crs: 4326,\n filter_by: \"DEPARTEMENT\",\n source: \"EXPRESS-COG-CARTO-TERRITOIRE\"\n }) ","pinned":true,"hidden":false,"mode":"ojs"},{"id":161,"value":"md`\n${print_program_departement_single(langage, departement, level_arrondissement, format, year)}\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":399,"value":"partie_3 = md`\n## Récupérer plusieurs valeurs\n\nLa récupération de fonds de carte est flexible, il est tout à fait possible de récupérer plusieurs unités d'intérêt à la fois\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":947,"value":"$35","pinned":true,"hidden":false,"mode":"ojs"},{"id":403,"value":"viewof multiple_departements = Inputs.select(liste_departements, {label: \"Sélectionner plusieurs départements\", multiple: true, value: '01'})","pinned":true,"hidden":false,"mode":"ojs"},{"id":915,"value":"//map_multiple_departement = map_multiple_4326(data_multiple_departement)","pinned":true,"hidden":false,"mode":"ojs"},{"id":416,"value":"multiple_departements","pinned":true,"hidden":false,"mode":"ojs"},{"id":618,"value":"md`${hint_title}`","pinned":true,"hidden":false,"mode":"ojs"},{"id":406,"value":"```python\nimport cartiflette.s3 as s3\nshp_communes = s3.download_vectorfile_url_all(\n crs = 4326,\n values = [${multiple_departements.map(department => `\"${department}\"`).join(\", \")}],\n borders=\"COMMUNE\",\n vectorfile_format=\"${format}\",\n filter_by=\"DEPARTEMENT\",\n source=\"EXPRESS-COG-CARTO-TERRITOIRE\",\n year=2022)\n```\n \n","pinned":true,"hidden":false,"mode":"md"},{"id":673,"value":"level_arrondissement = arrondissement ? \"COMMUNE_ARRONDISSEMENT\" : \"COMMUNE\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":302,"value":"## Quels sont les niveaux disponibles ?","pinned":true,"hidden":false,"mode":"md"},{"id":420,"value":"La production des fonds mis à disposition de manière flexible est encore artisanale. Voici la liste des formats disponibles dans la dernière version de `cartiflette`","pinned":true,"hidden":false,"mode":"md"},{"id":1028,"value":"//jsonData = (await fetch(url_file_available)).json()","pinned":true,"hidden":false,"mode":"ojs"},{"id":182,"value":"//viewof tt=Inputs.table(jsonData)","pinned":true,"hidden":false,"mode":"ojs"},{"id":187,"value":"## Annexes\n\n### Inputs","pinned":true,"hidden":false,"mode":"md"},{"id":590,"value":"logo = ({\n \"python\": `${fab`python`}`,\n \"javascript\": `${fab`js`}`,\n \"r\": `${fab`r-project`}`\n})","pinned":true,"hidden":false,"mode":"ojs"},{"id":640,"value":"langage = langage_requete == null ? \"Python\" : langage_requete","pinned":true,"hidden":false,"mode":"ojs"},{"id":600,"value":"hint_title = md` Comment faire en \\`${langage}\\` ${logo[langage.toLowerCase()]} ?`","pinned":true,"hidden":false,"mode":"ojs"},{"id":1250,"value":"viewof drom_rapproches = Inputs.toggle({label: \"Rapprocher les DROM ?\", value: true})","pinned":true,"hidden":false,"mode":"ojs"},{"id":36,"value":"viewof selectedlevel = Inputs.select(['DEPARTEMENT', 'REGION', 'BASSIN_VIE'], {label: \"Zonage désiré:\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":153,"value":"viewof year = Inputs.select([\"2022\"], {label: \"Année de la géographie de référence (plus d'années prochainement)\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":48,"value":"viewof format = Inputs.select(\n [\"topojson\", \"geojson\"],\n {label: \"Format désiré:\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":1268,"value":"viewof simplification_percent = Inputs.range([0, 50], {step: 50, value: 50, label: \"Degré de simplification (%)\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":1286,"value":"viewof simplification_percent_departement = Inputs.bind(\n Inputs.range([0, 50], {step: 50, value: 50, label: \"Degré de simplification (%)\"}),\n viewof simplification_percent\n )","pinned":true,"hidden":false,"mode":"ojs"},{"id":1115,"value":"### Récupération des données","pinned":true,"hidden":false,"mode":"md"},{"id":64,"value":"data_departement = get_france(selectedlevel, \"topojson\", year, drom_rapproches, simplification_percent)","pinned":true,"hidden":false,"mode":"ojs"},{"id":1201,"value":"map_france = topohelper\n .from(\n await data_departement\n )\n .project({ proj: l93 })\n .view({ tooltip: true, zoom: true })","pinned":true,"hidden":false,"mode":"ojs"},{"id":1279,"value":"create_url_france(selectedlevel, format, year, drom_rapproches, simplification_percent)","pinned":true,"hidden":false,"mode":"ojs"},{"id":491,"value":"button_france = html`\n ${download_button(\n create_url_france(selectedlevel, format, year, drom_rapproches, simplification_percent)\n )}\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":135,"value":"map_departement = topohelper\n // direct call inside from() to avoid a deep copy\n .from(\n await departement_shape\n )\n .project({ proj: l93 })\n .view({ tooltip: true, zoom: true })","pinned":true,"hidden":false,"mode":"ojs"},{"id":1182,"value":"departement_shape = get_departement(\n departement,\n arrondissement ? \"COMMUNE_ARRONDISSEMENT\" : \"COMMUNE\",\n \"topojson\",\n year,\n simplification_percent_departement\n )","pinned":true,"hidden":false,"mode":"ojs"},{"id":524,"value":"button_departement = html`\n ${download_button(\n create_url_departement(departement, arrondissement ? \"COMMUNE_ARRONDISSEMENT\" : \"COMMUNE\", format, year, simplification_percent_departement)\n )}\n`","pinned":true,"hidden":false,"mode":"ojs"},{"id":1215,"value":"map_multiple_departement = topohelper\n // direct call inside from() to avoid a deep copy\n .from(\n await data_multiple_departement_combine\n )\n .project({ proj: l93 })\n .view({ tooltip: true, zoom: true })","pinned":true,"hidden":false,"mode":"ojs"},{"id":99,"value":"viewof departement = Inputs.select(liste_departements, {label: \"Département à représenter\"})","pinned":true,"hidden":false,"mode":"ojs"},{"id":1340,"value":"topojson.topology(data_multiple_departement)","pinned":true,"hidden":false,"mode":"ojs"},{"id":927,"value":"data_multiple_departement = get_multiple_departement(multiple_departements, level_arrondissement, format, year)","pinned":false,"hidden":false,"mode":"ojs"},{"id":859,"value":"import {create_projection2154, map_multiple_2154, map_multiple_4326, make_map, print_program_france, print_program_departement_single} from \"@linogaliana/cartiflette-doc-utils\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":1210,"value":"data_multiple_departement_combine = to_single_geojson(data_multiple_departement)","pinned":true,"hidden":false,"mode":"ojs"},{"id":25,"value":"import {\n button, url_file_available,\n get_france, get_departement, liste_departements,\n get_multiple_departement, create_url_departement, create_url_france,\n to_single_geojson} from \"@linogaliana/cartiflette-js\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":1108,"value":"## Styles","pinned":true,"hidden":false,"mode":"md"},{"id":308,"value":"import { style as faStyle, fa, fab, fas } from \"@airbornemint/fontawesome\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":319,"value":"faStyle({regular: true, solid: true, brands: true})","pinned":true,"hidden":false,"mode":"ojs"},{"id":343,"value":"tachyons = {\n const src = \"https://unpkg.com/tachyons@4.10.0/css/tachyons.min.css\";\n const n = html``;\n const api = {\n attach: () => document.querySelector(\"head\").prepend(n),\n detach: () => n.parentNode && n.parentNode.removeChild(n)\n };\n api.attach();\n invalidation.then(api.detach);\n return api;\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":347,"value":"ns = Inputs.text().classList[0]","pinned":true,"hidden":false,"mode":"ojs"},{"id":345,"value":"html``","pinned":true,"hidden":false,"mode":"ojs"},{"id":353,"value":"import {reset, view} from \"@saneef/is-observable-inputs-style-able\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":498,"value":"function download_button(url) {\n return ``\n}","pinned":true,"hidden":false,"mode":"ojs"},{"id":533,"value":"","pinned":true,"hidden":false,"mode":"html"},{"id":1191,"value":"// Projection Lambert 93 (EPSG: 2154)\nl93 = \"+proj=lcc +lat_0=46.5 +lon_0=3 +lat_1=49 +lat_2=44 +x_0=700000 +y_0=6600000 +ellps=GRS80 +towgs84=0,0,0,0,0,0,0 +units=m +no_defs +type=crs\"","pinned":true,"hidden":false,"mode":"ojs"},{"id":1188,"value":"topohelper = import(\"https://cdn.jsdelivr.net/npm/topohelper@0.4.3/+esm\")","pinned":true,"hidden":false,"mode":"ojs"}],"files":"$W36","stdlib":"1","titling":"auto"}