Chantiers des lieux

Lot 1 – Septembre 2024

Ajout de la surcharge d’un nom de lieu sur un objet touristique.

Jusqu’à présent, un lieu utilisé sur plusieurs objets touristique avait le même nom sur toutes les offres (Adresse > Nom du lieu). Il est désormais possible de modifier localement sur un objet touristique le nom du lieu que l’on souhaite afficher, sans impacter le lieu en question.

Exemple : mon lieu « Parc des Expositions » est utilisé sur la manifestation A et la manifestation B. La manifestation A se déroule dans la salle 1 ; la manifestation B dans la salle 2. Chaque manifestation va donc pouvoir référencer le lieu « Parc des Expositions », en surchargeant localement le nom du lieu pour préciser « Parc des Expositions – Salle 1 » ou « Parc des Expositions – Salle 2 ».

Impact sur les API de lecture

Le nom du lieu sera renvoyé de façon différente. Pour un objet utilisant un lieu, la structure sera désormais :

• localisation.adresse.nomDuLieu : Valeur du nom du lieu sur l’objet touristique.
• localisation.adresse.surchargeNomDuLieu : Nouveau champ, Booléen indiquant la présence d’une surcharge locale ou non, utilisé que quand l’objet référence un lieu.
  • true : le nom du lieu a été surchargé localement
  • false : le nom du lieu est le même sur l’objet et sur le lieu qu’il référence.
• localisation.lieu : données relatives au lieu de référence, comprenant notamment le nom original (localisation.lieu.nom),
• localisation.lieuObjetTouristique : données relatives à l’objet touristique dont est issu le lieu,
• informations<Type Objet>.nomLieu : valeur synchronisée avec localisation.adresse.nomDuLieu

Exemple de JSON renvoyé pour un objet utilisant un lieu issu d’un objet touristique :

{
    "type": "FETE_ET_MANIFESTATION",
    "nom": {
        "libelleFr": "Test Lieux - FMA 39415"
    },
    "localisation": {
        "adresse": {
            "nomDuLieu": "CCI Surcharge Test",
             "surchargeNomDuLieu": true,
            "adresse1": "20 rue de la Bourse",
            "codePostal": "69002",
            "commune": {
                "id": 28739,
                "code": "69382",
                "nom": "Lyon 2ème",
                "pays": {
                    "elementReferenceType": "Pays",
                    "id": 532,
                    "libelleFr": "France",
                    "ordre": 78
                },
                "codePostal": "69002"
            }
        },
...
        "lieu": {
            "id": 4675,
            "nom": {
                "libelleFr": "Chambre de Commerce et d'Industrie Lyon Metropole (CCI)"
            }
        },
...
        "lieuObjetTouristique": {
            "type": "COMMERCE_ET_SERVICE",
            "id": 141710,
            "nom": {
                "libelleFr": "Chambre de Commerce et d'Industrie Lyon Metropole (CCI)"
            },
            "identifier": "sitraCOS704656",
            "state": "PUBLISHED",
            "adresse": {
                "surchargeNomDuLieu": false,
                "adresse1": "20 rue de la Bourse",
                "codePostal": "69002",
                "commune": {
                    "id": 28739,
                    "code": "69382",
                    "nom": "Lyon 2ème",
                    "pays": {
                        "elementReferenceType": "Pays",
                        "id": 532,
                        "libelleFr": "France",
                        "ordre": 78
                    },
                    "codePostal": "69002"
                }
            },
            "geolocalisation": {
                "altitude": 179,
                "valide": true,
                "geoJson": {
                    "type": "Point",
                    "coordinates": [
                        4.836216,
                        45.764350
                    ]
                }
            }
        }
    },
    "informationsFeteEtManifestation": {
        "portee": {
            "elementReferenceType": "FeteEtManifestationPortee",
            "id": 2350,
            "libelleFr": "Nationale",
            "ordre": 2,
            "description": "La manifestation peut intéresser des spectateurs dans un rayon de 200 à 1000 km."
        },
        "nomLieu": "CCI Surcharge Test"
    }
}

Impact sur les API d’écriture

Il sera possible de mettre à jour la surcharge locale du nom d’un lieu sur un objet touristique.

Pour ce faire :

• Dans root.fieldList, rajouter « localisation.adresse.nomDuLieu » et « localisation.adresse.surchargeNomDuLieu« ,
• Dans root, bien renvoyer ces deux champs dans le JSON.

Exemple de payload pour modifier un objet ayant un lieu et une surcharge locale :

{
    "type": "FETE_ET_MANIFESTATION",
    "nom": {
        "libelleFr": "Test Lieux - FMA 39415"
    },
    "localisation": {
        "adresse": {
            "nomDuLieu": "Surchage locale du nom du lieu",
             "surchargeNomDuLieu": true,
            "adresse1": "20 rue de la Bourse",
            "codePostal": "69002",
            "commune": {
                "id": 28739,
                "code": "69382",
                "nom": "Lyon 2ème",
                "pays": {
                    "elementReferenceType": "Pays",
                    "id": 532,
                    "libelleFr": "France",
                    "ordre": 78
                },
                "codePostal": "69002"
            }
        },
...
        "lieu": {
            "id": 4675,
            "nom": {
                "libelleFr": "Chambre de Commerce et d'Industrie Lyon Metropole (CCI)" 
            }
        },
...

Cas identifiés :

localisation.adresse.surchargeNomDuLieu	localisation.adresse.nomDuLieu	Résultat
true	non nulle	Surcharge locale non nulle appliquée sur l’objet
true	nulle	Surcharge locale nulle appliquée sur l’objet
false	nulle ou non nulle	Pas de surcharge locale appliquée