N’importe quel type de texte peut être défini comme type d’affichage de composant LocationLookup, ce qui vous permet d’utiliser l’API de Google pour extraire les données d’adresse.

Le type d’affichage du composant de champ LocationLookup exploite l’API Google Places pour extraire les données d’adresse qui peuvent être utilisées pour la configuration et la tarification d’un emplacement unique. N’importe quel type de champ de texte peut être défini comme type d’affichage de composant LocationLookup à l’aide de l’éditeur de mise en page ou en modifiant directement un fichier CSV de mise en page.

Pour le voir en action, visionnez la vidéo suivante :

Type d’affichage du composant du champ de recherche d’emplacement

Pour utiliser un champ LocationLookup, vous devez d’abord disposer d’une clé API valide de Google avec l’autorisation d’accéder à Google Places. La clé API doit être configurée pour l’API JavaScript Maps et l’API Places.

La valeur du champ nécessite deux propriétés : key et fieldMapping.

{
  "key": API-Key-string,
  "fieldMapping": {"[field1VariableName]":"[returnedPlaceType]","[field2VariableName]":"[returnedPlaceType]"}
}

La propriété clé fait référence à la clé API.

Utilisez la propriété fieldMapping pour demander à l’interface utilisateur de mapper les données de lieu renvoyées à différents champs de la configuration. Cette propriété peut prendre soit une chaîne, soit un objet de paires clé :valeur (les deux chaînes).

Si une chaîne est fournie :

• La chaîne doit être le nom de variable d’un champ dans la configuration
• Les données renvoyées par l’API sont converties en chaîne et mappées à la valeur du champ

Si un objet est fourni :

• Les clés seront le nom de variable du champ dans la configuration
• Les valeurs seront le chemin JSON vers les données de l’API qui doivent être mappées au champ

Pour en savoir plus sur l’apparence de ces données, consultez : Détails du lieu

Lorsque vous mappez des composants d’adresse, ceux-ci reviennent sous la forme d’un tableau des différentes valeurs de composant, il n’y a donc pas de chemin simple. L’interface utilisateur attend quelque chose au format suivant :

address_components.[component type]

Notez que tous les types répertoriés ne sont pas garantis d’être renvoyés par l’API de détails du lieu. Pour trouver les types pris en charge, consultez le site Web de Google suivant :

Types de lieu

Exemple de valeur de champ :

{
    "key": "*********",
    "fieldMapping": {
        "formattedAddress": "formatted_address",
        "sublocality": "address_components.sublocality",
        "city": "address_components.locality",
        "stateForLocation": "address_components.administrative_area_level_1",
        "zipCode": "address_components.postal_code"
    }
}

Ce mappage fonctionne également par ensembles. Notez que le champ d’emplacement et tous les champs répertoriés dans le mappage doivent également faire partie de l’ensemble. Les champs d’index croisés ou globaux ne sont pas pris en charge dans un ensemble.

Voici quelques mappages courants de l’API Google Places :

• formatted_address (renvoie l’adresse entière sous une forme lisible par l’homme)
• address_components.locality (renvoie la ville)
• address_components.administrative_area_level_1 (renvoie l’état)
• address_components.country
• address_components.postal_code
• address_components.street_number
• address_components.route (renvoie uniquement le nom de la rue)