Module:Adresse

 Documentation[voir] [modifier] [historique] [purger]

Ce module permet l'extraction d'une adresse depuis Wikidata et sa mise en forme.

Utilisation

Fonctions exportables

• streetAddress(item, area) – Met en forme l'adresse partielle avec le numéro de rue et la rue ;
• adminDivList(item, country) – Retourne la liste des subdivisions territoriales (commune, départements, cantons,… ) du pays en paramètre selon les données entrées dans Module:Adresse/Formats ;
• cityLine(item, country, divlist, postcode) – Met en forme l'adresse partielle avec le nom de la ville, les noms des subdivisions territoriales et le code postal ;
• fullAddress(item, country, divs, streetstr, divstr, showcountry, postcode) – Met en forme l'adresse complète contenant numéro de rue, nom de rue, nom de la ville, noms des subdivisions territoriales, code postal et nom du pays et ajoute la catégorie Catégorie:Page utilisant une adresse fournie par Wikidata ;
• wikidataAddress(item, country) – Reprend l'adresse de rue issue de streetAddress et y ajoute la catégorie Catégorie:Page utilisant une adresse fournie par Wikidata.

Modules externes et autres éléments dont ce module a besoin pour fonctionner

• mw.ustring.gsub – Remplace toutes les occurrences d'un motif dans une chaîne de caractères par une chaîne de remplacement ;
• mw.text.listToText – Joint les éléments d'une liste pour former une chaîne de caractères ;
• mw.text.trim – Enlève les espaces et autres caractères au début et à la fin d'une chaine de caractères ;
• Module:Wikidata – Module contenant des fonctions de récupération des données depuis Wikidata ;
• Module:Linguistique – Module contenant des fonctions de mise en forme et d'analyse basique d'une chaîne de caractères ;
• Module:Country data – Module de mise en forme des noms de lieux et des nationalités.

Module en sous-page

• Module:Adresse/Formats – Table contenant les paramètres de mise en forme de l'adresse selon le pays.

Modules lua utilisant ce module

• Module:Infobox/Fonctions/Bâtiment ;
• Module:Infobox/Fonctions/Centrale électrique ;
• Module:Infobox/Abbaye ;
• Module:Infobox/Centre commercial ;
• Module:Infobox/Centre de congrès ;
• Module:Infobox/Gratte-ciel ;
• Module:Infobox/Stade ;
• Module:Infobox/Temple bouddhiste.

Modèles appelant directement ce module

Aucun

Exemples

La documentation de ce module est générée par le modèle {{Documentation module}}.
Elle est incluse depuis sa sous-page de documentation. Veuillez placer les catégories sur cette page-là.
Les éditeurs peuvent travailler dans le bac à sable (modifier).
Voir les statistiques d'appel depuis le wikicode sur l'outil wstat et les appels depuis d'autres modules.

local p = {}

local wikidata =require('Module:Wikidata')

local areaformatting = {
	-- identifant wikipédia = regex pour le format de l'adresse 
		-- $number : le numéro de l'immeuble
		-- $ street : le nom de la rue
	-- questions :
		-- utiliser des noms plutôt que des ID wikidata ?
		-- si problème de performance, utiliser des fonctions plutôt que des regex ?
	Q16 = '$number $street',-- Canada
	Q31 = '$number $street',-- Belgique
	Q40 = '$street $number', -- Autriche
	Q183 = '$street $number', -- Allemagne
	Q39 = '$street $number', -- Suisse
	Q142 = '$number $street',-- France
	default = '$number $street',
	}

local function formatStreet(streetname, housenumber, area)
	local val = areaformatting[area] or areaformatting['default']
	val = mw.ustring.gsub(val, '$number', housenumber or '')
	val = mw.ustring.gsub(val, '$street', streetname or '')
	return val
end

function p.formatAddress(streets, postcode, city, formattingarea)
	-- streets est une table de {streetname, number, }quarge que "city" qui détermine le formatage de la rue et du code postal
	if (not streets or #streets == 0) and (not postcode) and (not city) then 
		return nil
	end

	local addresslines = {} -- lignes à mettre dans l'adresse : rue, codepostal + ville etc.
	if streets then
		table.insert(addresslines, mw.text.listToText(streets))
	end
	if postcode or formattingarea then
		table.insert(addresslines, (postcode or '') .. ' ' .. (formattingarea or ''))
	end
	return table.concat(addresslines, '<br />')
end

local function numberFromClaim(claim) -- récupère le numéro de l'immeuble à partir d'un qualificatif P670 d'une affirmation Wikidata
	if not claim.qualifiers or not claim.qualifiers.P670 then
		return nil
	end
	local vals = {}
	for i, j in pairs(claim.qualifiers.P670) do
		table.insert(vals, wikidata.formatSnak(j))
	end
	return table.concat(vals, '-')
end

local function streetFromClaims(claim) -- réupère le nom de la rue à partir d'une affirmation P669 Wikidata
	if not claim.mainsnak.snaktype == 'value' then
		return nil
	end
	local streetname = wikidata.formatSnak(claim.mainsnak)
	local direction = 	wikidata.getFormattedQualifiers(claim, {'P560'}, {link='-'}) -- par exemple "rue Sherbrooke OUest"
	if direction then 
		return streetname .. ' ' .. direction
	else
		return streetname
	end
end

local function wikidatastreet(claim , area) --formate des données sur la rue à partir d'une affirmation Wikidata
	local streetname = streetFromClaims(claim)
	local housenumber =  numberFromClaim(claim)
	return  formatStreet(streetname, housenumber, area)
end

function p.wikidataAddress(item) -- fprùate l'intégralité d'une adresse à partir des données contenues dans une élément Wikidata
	-- essaye la propriété P669 (données de type 'élément'
	-- TODO : récupérer la zone géographique pour le formatage
	local streetclaims = wikidata.getClaims{item=item, property = 'P669', item=item}
	local streetstrings = {}
	local area = wikidata.getClaims({item = item, property = 'P17'}) -- utilise le pays comme approximation pour le format d'adresse à utiliser
	if area and #area > 0 then
		area = wikidata.getmainid(area[1])
	end
	if streetclaims then
		for i, j in pairs(streetclaims) do
			streetstrings[i] = wikidatastreet(j, area)
		end
	else
	-- sinon,essaye p969: datatype: string
		streetclaims =  wikidata.getClaims{property = 'P969', item=item}
		if streetclaims then for i, j in pairs(streetclaims) do
			local street = wikidata.formatStatement(j)
			streetstrings[i] = street
			end end
	end
	-- code postal
	local postcode = wikidata.getClaims{property= 'P281', item=item}
	if postcode and #postcode > 1 then -- s'il y a plusieurs codes postaux, il y a sans doute plusieurs adresses différentes, c'est difficile de savoir lequel correspond à laquelle
		postcode = nil 
	elseif postcode then
		postcode = wikidata.formatStatement(postcode[1])
	end
	-- faaut-il essayer d'ajouter la ville par P131 ? Souvent on en veut pas (par exemple en infobox)
	local val = p.formatAddress(streetstrings, postcode)
	if val then return
		val .. '[[Category:Page utilisant une adresse fournie par Wikidata]]'
	end
end
return p