Aide de l’API MediaWiki

Ceci est une page d’aide de l’API de MediaWiki générée automatiquement.

Documentation et exemples : https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page [archive]

list=geosearch (gs)

(main | query | geosearch)
  • Ce module nécessite des droits de lecture.
  • Ce module peut être utilisé comme générateur.
  • Source : GeoData
  • Licence : WTFPL

Renvoie les pages qui ont des coordonnées situées dans une zone donnée.

Paramètres :
D'autres paramètres généraux sont disponibles.
gscoord

Coordonnées autour desquelles chercher.

Format : latitude et longitude séparées par une barre verticale (|).

gspage

Titre de la page autour de laquelle effectuer la recherche.

gsbbox

Boîte englobant la zone à rechercher : coordonnées séparées par une barre verticale (|) des coins supérieur gauche et inférieur droit.

gsradius

Rayon de recherche, en mètres.

Type: entier
La valeur doit être entre 10 et 10 000.
Par défaut : 500
gsmaxdim

Restreindre la recherche à des objets qui ne sont pas plus grands que cela, en mètres.

Type: entier
gssort

Détermine l’ordre de tri des résultats renvoyés.

distance
Classer les pages par leur distance au centre.
relevance
Classer les pages par leur pertinence selon CirrusSearch, de façon similaire à ce que fait Special:Search. Actuellement pris en charge seulement sur les wikis qui utilisent le moteur ElasticSearch, voir mw:Extension:GeoData#Search backends.
Une des valeurs suivantes : distance, relevance
Par défaut : distance
gslimit

Nombre maximal de pages à retourner.

Type : entier ou max
La valeur doit être entre 1 et 500.
Par défaut : 10
gsglobe

Globe sur lequel chercher. Voir mw:Special:MyLanguage/Extension:GeoData#Glossary pour les détails.

Une des valeurs suivantes : earth
Par défaut : earth
gsnamespace

Espaces de nom à rechercher.

Valeurs (séparées par | ou autre) : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 102, 103, 106, 107, 108, 109, 112, 113, 114, 115, 420, 421, 460, 461, 1198, 1199, 2600, 4000, 4001, 4002, 4003, 4004, 4005, 4006, 4007, 4008, 4009, 4010, 4011, 4100, 4101, 5500, 5501
Pour spécifier toutes les valeurs, utiliser *.
Par défaut : 0
gsprop

Quelles propriétés de coordonnées supplémentaires retourner. (Propriétés toujours retournées : lat, lon et un des drapeaux booléens primary ou secondary).

type
Type de l’objet sur lequel pointent les coordonnées. Voir mw:Special:MyLanguage/Extension:GeoData#Usage pour les détails.
name
Nom de l’objet.
dim
Taille approximative de l’objet en mètres.
country
Code ISO 3166-1 alphanumérique sur 2 caractères du pays (par exemple US ou RU).
region
Code de région ISO 3166-2 (la partie du code ISO 3166-2 après le code de pays et le tiret ; par ex. FL pour l’État de Floride ou MOS pour l’oblast de Moscou).
globe
À quel corps terrestre sont relatives les coordonnées (par ex. moon ou pluto). Par défaut, la Terre. Voir mw:Special:MyLanguage/Extension:GeoData#Glossary pour plus de détails.
Valeurs (séparées par | ou autre) : country, dim, globe, name, region, type
Par défaut : globe
gsprimary

Quel type de coordonnées renvoyer.

primary
Géolocalisation du sujet de l’article. Il ne peut y avoir qu’un seul jeu primaire de coordonnées par titre.
secondary
L’emplacement d’un objet mentionné dans l’article. Un nombre quelconque de coordonnées secondaires peut être associé avec un titre.
all
Renvoyer toutes les coordonnées primaires et secondaires.
Une des valeurs suivantes : all, primary, secondary
Par défaut : primary
Exemples :
Rechercher autour du point ayant les coordonnées 37° 47′ 13,1″ N 122° 23′ 58,84″ O.
api.php?action=query&list=geosearch&gsradius=10000&gscoord=37.786971|-122.399677 [ouvrir dans le bac à sable]
Rechercher dans une boîte englobante
api.php?action=query&list=geosearch&gsbbox=37.8|-122.3|37.7|-122.4 [ouvrir dans le bac à sable]