API:Jazykové vyhledávání

Požadavek GET pro vyhledání jazyka v libovolném skriptu podle jeho názvu, ISO kódu nebo nativního názvu.

Dokumentace API

action=languagesearch

(main | languagesearch)

• This module requires read rights.
• Source: Universal­Language­Selector
• License: GPL-2.0-or-later OR MIT

Search for language names in any script.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Languagesearch

Specific parameters:

Other general parameters are available.

search

Search string.

This parameter is required.

typos

Number of spelling mistakes allowed in the search string.

Type: integer

Default: 1

Examples:

Search for "Te"

api.php?action=languagesearch&search=Te [open in sandbox]

Search for "ഫി"

api.php?action=languagesearch&search=ഫി [open in sandbox]

Search for "ഫി", allowing one typo

api.php?action=languagesearch&search=ഫി&typos=1 [open in sandbox]

Příklad

Dotazování přes GET

api.php?action=languagesearch&search=gu [zkuste v ApiSandbox]

Odpověď

{
    "languagesearch": {
        "gu": "gujarati",
        "gaa": "ga",
        "gn": "guarani",
        ...
    }
}

Ukázkový kód

Python

#!/usr/bin/python3

"""
    languagesearch.py

    MediaWiki API Demos
    Demo of `Languagesearch` module: Search for a language in any language

    MIT License
"""

import requests

S = requests.Session()

URL = "https://en.wikipedia.org/w/api.php"

PARAMS = {
    "action": "languagesearch",
    "search": "Gu", #Could be name of the language, its iso code or native name
    "format": "json"
}

R = S.get(url=URL, params=PARAMS)
DATA = R.json()

LANG = DATA['languagesearch']
for code, name in LANG.items():
    print(code + ": " + name)

PHP

<?php
/*
    languagesearch.php

    MediaWiki API Demos
    Demo of `Languagesearch` module: Search for a language in any language

    MIT License
*/

$endPoint = "https://en.wikipedia.org/w/api.php";
$params = [
    "action" => "languagesearch",
    "search" => "Gu",
    "format" => "json"
];

$url = $endPoint . "?" . http_build_query( $params );

$ch = curl_init( $url );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
$output = curl_exec( $ch );
curl_close( $ch );

$result = json_decode( $output, true );

foreach( $result["languagesearch"] as $langcode => $langname ) {
    echo( $langcode . ": " . $langname . "\n" );
}

JavaScript

/*
    languagesearch.js

    MediaWiki API Demos
    Demo of `Languagesearch` module: Search for a language in any language

    MIT License
*/

var url = "https://en.wikipedia.org/w/api.php"; 

var params = {
    action: "languagesearch",
    search: "Gu",
    format: "json"
};

url = url + "?origin=*";
Object.keys(params).forEach(function(key){url += "&" + key + "=" + params[key];});

fetch(url)
    .then(function(response){return response.json();})
    .then(function(response) {
        var langs = response.languagesearch;
        for (var lang in langs) {
            console.log(lang + ": " + langs[lang] );
        }
    })
    .catch(function(error){console.log(error);});

MediaWiki JS

/*
	languagesearch.js

	MediaWiki API Demos
	Demo of `Languagesearch` module: Search for a language in any language

	MIT License
*/

var params = {
		action: 'languagesearch',
		search: 'Gu',
		format: 'json'
	},
	api = new mw.Api();

api.get( params ).done( function ( data ) {
	var langs = data.languagesearch,
		lang;
	for ( lang in langs ) {
		console.log( lang + ': ' + langs[ lang ] );
	}
} );

Demo aplikace

• 

  Snímek obrazovky nástroje Universal Language Selector, který používá toto rozhraní API

  Poskytuje a primárně používá Rozšíření:UniversalLanguageSelector , který umožňuje uživatelům vybrat si jazyk a snadno nakonfigurovat jeho podporu.
• překladatelský robot pro telegramy, který přijímá vstup přes chatovou zprávu pro výběr jazyka. Viz kód pomocí API.

Možné chyby

Kód	Popis
nosearch	The search parameter must be set.

Další poznámky

• Interně toto API ukládá velmi dlouhý seznam názvů jazyků v mnoha různých jazycích. Hlavním zdrojem tohoto seznamu je Common Locale Data Repository spolu s několika doplňky příruček.

Související odkazy

• API:All search modules