Le complément idéal de l'action osmap pour éviter la recherche des coordonnées d'une adresse.

🆙 geocode : retourne les coordonnées GPS d'une adresse postale

Cliquer pour lire la documentation

syntaxe {up geocode=adresse postale}
mots-clé pour template : ##latitude##, ##longitude##, ##adresse##
@version: UP-502 @author : Lomart @license: GNU/GPLv3 @credit: script xxx de xxx @tags: Groupe pour bouton editeur
  • geocode: adresse postale
  • template (item-template) = "##latitude##,##longitude##": mise en forme pour retour

mentions obligatoire pour utiliser l'API

  • site: url du site. Si vide, on utilise celle du serveur
  • email: adresse email du site. Si vide, on utilise 'webmaster@tld_site''
  • ssl: état SSL. permet de forcer l'état. Vide, on récupère la config serveur

Un exemple simple

{up osmap={up geocode=1 rue de la paix, paris}}

osmap attend les coordonnées d'une adresse sous la forme latitude,longitude.
geocode va utiliser l'API nominatim de openstreetmap.org pour les récupérer.

N'aurait-il pas été préférable d'incorporer cette fonctionnalité à l'action osmap ?

Peut-être, mais une action séparée permet de ne pas compliquer l'action osmap et de pouvoir, si besoin, l'utiliser séparément.
Par exemple, avec l'action mapael.

Pour respecter les conditions d'utilisation de l'API nominatim, un système de mise en cache est activée.
Pour une adresse, une seule requête sera faite, les appels suivants utiliseront les données en cache dans le dossier tmp/up-geocode

Les options

template
permet de mettre en forme les données retournées. par défaut : ##latitude##,##longitude##

Il existe également le mot-clé ##adresse## qui retourne les informations détaillées sur l'adresse

{up geocode=1 rue de la paix, paris | template=##adresse##}
1, Rue de la Paix, Quartier Gaillon, Paris 2e Arrondissement, Paris, Île-de-France, France métropolitaine, 75002, France
site
email
les conditions d'utilisation de l'API nominatim demande une identification du demandeur.

Par défaut, ces options seront automatiquement argumentées par l'URL du site et une adresse email générique (webmaster@tld-du-site)

Vous pouvez les définir avec les valeurs de votre choix

Pour info, cette page utilise 10 action(s) :
grid (1) upactionslist (1) flexauto (1) osmap (1) geocode (2) csv2def (1) jcontent-info (1) tabslide (1) toc (1)

Dernières modifications

Sommaire: Toutes les actions