Co ve V2 znamená source?
Pole source ukazuje, která cesta vytvořila konečný výsledek: vyhledání v uložené datové sadě, odhad pomocí AI, nebo žádný vybraný zdroj. Nejde o odkaz na původního vydavatele datové sady, o doklad licence ani o záruku, že je odhad správný.
Tento průvodce popisuje současnou specifikaci odpovědí V2 a profil databáze, který GenderAPI.io vytvořilo samo. Níže uvedená pozorování jsou naměřené počty a kontroly konzistence; zkontrolovaný katalog původních zdrojů a nezávislé měření přesnosti zatím zveřejněny nejsou.
| source | Co vám říká | Co neurčuje |
|---|---|---|
dataset | Byl vybrán uložený řádek; při přesně stejném počtu může být pohlaví přesto neznámé | Původního vydavatele, způsob sběru, licenci, stáří řádku ani nezávislost pozorování |
ai | Konečná odpověď pochází z nakonfigurované cesty odhadu pomocí AI; gender může být přesto null | Spočítaný vzorek, odkaz na datovou sadu ani kalibrovanou přesnost odhadu |
none | Pro konečný výsledek v režimu pouze s datovou sadou nebyl vybrán žádný uložený řádek | Že vstup nemá žádné možné přiřazení ke jménu v žádné populaci ani v žádném jazyce |
Profil databáze: 26. září 2026
Metadata kolekcí byla načtena 2026-09-26T15:28:18.227Z a náhodné vzorky 2026-09-26T15:31:54.045Z. Oba počty pocházejí z metadat MongoDB collStats pro každou kolekci, nikoli ze samostatného úplného sčítání. Obecná kolekce obsahuje uložené řádky jmen a kolekce pro jednotlivé země obsahuje uložené řádky pro jméno a zemi. Počty se nesmějí sčítat do celkového počtu jedinečných jmen nebo jedinečných osob.
Pro každou kolekci MongoDB náhodně vybrala 5 000 dokumentů a na databázovém serveru vypočítala níže uvedené souhrnné kontroly. Veřejná zpráva neobsahuje žádná jména ani surové záznamy. Jde o vlastní pozorování GenderAPI.io v provozované databázi, nikoli o nezávislý audit ani o zmrazenou datovou sadu pro hodnocení. Kontroly se týkají konzistence počtů, nikoli přesnosti odhadů, počtu jedinečných osob nebo jmen ani pokrytí API.
| Pozorování | Obecné řádky | Řádky pro konkrétní zemi |
|---|---|---|
| Kolekce | general | country-specific |
| Počet dokumentů podle metadat | 2 483 220 | 4 080 692 |
| Uložený jedinečný klíč | name | name + country |
| Náhodně vybrané dokumenty | 5 000 | 5 000 |
| Porušení číselných pravidel ve vzorku | 0 | 0 |
| male + female se ve vzorku liší od total | 0 | 0 |
| Stejný počet male a female ve vzorku | 124 | 94 |
| Pole updated_at je ve vzorku přítomno | 667 / 5 000 | 741 / 5 000 |
Co kontroly databáze prokazují
Číselná kontrola vyžaduje, aby total bylo kladné bezpečné celé číslo a aby počty male a female byly konečné a ležely mezi 0 a total. Samostatná kontrola porovnává male + female s total. Všechny čítače ve vzorcích těmito kontrolami prošly; nejde o tvrzení, že je konzistentní každý řádek v kolekcích nebo že je některý odhad správný.
Stejný počet male a female se vyskytl ve 124 řádcích vzorku z obecné kolekce a v 94 řádcích vzorku z kolekce pro jednotlivé země. Jde o shodu uložených počtů, nikoli o nezávisle ověřené nejednoznačné identity ani o podíl neznámých výsledků API. Skutečné výsledky API závisejí na vstupech, dostupnosti Redis, výběru kandidátů a nastavení AI.
Samostatný soupis pole country v obecné kolekci, provedený 2026-09-26T15:33:13.811Z, našel 244 různých uložených hodnot: 239 měly formát dvou velkých písmen a 5 ne. Zda jsou hodnoty platnými kódy ISO, rozložení řádků pro konkrétní země ani pokrytí podporovaných zemí se neměřilo. Tato čísla nejsou počtem podporovaných zemí.
V obou vzorcích se neobjevilo žádné pole pro zdroj ani licenci. To neprokazuje, že údaje o původu chybějí v každém řádku nebo v externích systémech. updated_at se v některých řádcích vyskytovalo jako číselné pole, jeho hodnoty a význam však nebyly zkoumány; neurčuje aktuálnost dat ani plán aktualizací.
V2 provádí vyhledávání v datové sadě přes Redis. Dne 26. září 2026 GenderAPI.io jako správce systému potvrdilo, že MongoDB a Redis obsahují stejnou datovou sadu. Tato shoda vychází z uvedeného potvrzení: nezávislé porovnání obou databází se neprovedlo a taková kontrola zbývá. Výše uvedený soupis popisuje uložené řádky; pokrytí odpovědí API závisí také na odeslaných vstupech, shodě kandidátů a nastavení AI. Vzorky byly vybrány bez pevné počáteční hodnoty, načteny bez zmrazeného snímku a neměly nezávislá referenční označení; nemohou měřit přesnost odhadů, kalibraci ani pokrytí odpovědí.
Sledujte podklady v odpovědi
| Pole | Význam | Omezení |
|---|---|---|
input | Opakuje odeslaný typ vstupu, hodnotu a kontext země | Vstupní hodnota není nezávisle ověřeným údajem o identitě |
match.name / match.method | Ukazuje vybraného kandidáta a to, zda byl normalizován, rozdělen na části jména, získán jako podřetězec, nebo odvozen modelem | Shoda s částí jména nezaručuje, že bylo z celého jména nebo uživatelského jména odděleno skutečné křestní jméno |
match.scope / match.country | Ukazuje, zda vybraný uložený řádek pochází z vyhledávání pro konkrétní zemi, nebo z globálního vyhledávání | Uvedená země nezaručuje, že existoval řádek pro tuto zemi |
sample_count | Celkový počet uložený ve vybraném řádku; null u odhadu pomocí AI | Nemusí jít o jedinečné osoby, nezávisle získaná pozorování ani o velikost hodnocení přesnosti |
confidence / confidence_kind | Rozlišuje poměr z uložených počtů od hodnoty uvedené modelem | Žádná z hodnot není ověřenou pravděpodobností genderové identity osoby |
country / country_source | Metadata země pro vrácený řádek nebo přiřazení jména k zemi pomocí AI, pokud jsou k dispozici | Nejde o státní příslušnost, bydliště ani ověřený původ ani o důkaz, že se shodovala země z požadavku |
Jak shoda vstupu ovlivňuje výsledek
Vyhledávání v datové sadě normalizuje text a odvozuje kandidáty v podobě částí jména. U e-mailových adres se kandidáti odvozují z lokální části; u uživatelských jmen se odstraní volitelný znak @ na začátku. Běžné vyhledávání e-mailových adres a uživatelských jmen může zkoušet i omezený počet podřetězců jako kandidátů. Pokud je k dispozici více řádků kandidátů, vybere se řádek s nejvyšším uloženým celkovým počtem. Může to být jiná část jména než zamýšlené křestní jméno.
Pokud je uveden kontext země, vyhledávání zkusí u každého kandidáta řádek pro danou zemi, a pokud chybí, použije globální řádek. Konečný výsledek uvádí vybranou shodu. Nejednoznačný řádek pro konkrétní zemi se automaticky nenahradí globálním řádkem pro stejného kandidáta.
Běžný pokyn pro AI žádá rozpoznatelné křestní jméno. forceToGenderize navíc povoluje přiřazení podle osobních přezdívek nebo aliasů, takže pohlaví jiné než null spolu s name: null je v tomto režimu platné. Jde o různé úlohy odhadu, které je třeba hodnotit zvlášť.
Vyhledávání v datové sadě a zpracování pomocí AI
Pokud se použije AI, V2 předá odeslané type, value a kontext země službě nakonfigurované pro odhady pomocí AI. U e-mailových adres pokyn žádá model, aby ignoroval doménu a příponu za znakem plus; neslibuje se tím, že se tyto znaky z hodnoty před zpracováním pomocí AI odstraní. Pokud váš postup vyžaduje odhady pouze z datové sady, použijte ai_mode: off bez forceToGenderize.
Validace odpovědi AI kontroluje pole JSON, jejich typy a vzájemnou konzistenci. Neprokazuje, že vrácené jméno, přiřazení k pohlaví nebo přiřazení k zemi jsou správné. Veřejný výsledek neobsahuje název modelu, verzi modelu ani zdroj odhadu.
| Možnost | Cesta odhadu | Vrácené podklady |
|---|---|---|
| ai_mode: off | Používá pouze vyhledávání v datové sadě | Metadata vybraného řádku datové sady nebo neznámý výsledek bez vybraného řádku |
| ai_mode: fallback | Nejprve zkusí datovou sadu; pokud nevrátí pohlaví, použije AI | Podklady konečné cesty, nikoli společný vzorek z datové sady a AI |
| ai_mode: always | Používá přímo nakonfigurovanou cestu odhadu pomocí AI | Hodnota uvedená modelem nebo neznámý výsledek s confidence null; sample_count je vždy null |
| forceToGenderize: true | Zkusí datovou sadu, a pokud nepřinese výsledek, AI s analýzou přezdívek | Podklady z datové sady nebo přiřazení podle aliasu uvedené modelem; name může být null |
Dokumentace zdrojů, která zatím není zveřejněna
Zkontrolovaný katalog zdrojů zde není zveřejněn. Samotná specifikace odpovědí a chování implementace nemohou potvrdit původ dat, oprávnění zdroj používat, jeho reprezentativnost ani kvalitu jeho označení. Než zazní tvrzení o konkrétních zdrojích, je třeba zdokumentovat a zkontrolovat následující podklady.
Tato kontrola dokumentace neurčuje, zda jsou původní zdroje licencované, či nelicencované, úplné, nebo neúplné. Popisuje omezení veřejných podkladů. Pokud vaše použití vyžaduje posouzení konkrétního zdroje, kontaktujte GenderAPI.io.
| Podklad | Požadovaná dokumentace | Veřejný stav |
|---|---|---|
| Původ a oprávnění k použití | Pojmenovaný zdroj nebo vydavatel, období sběru, licence nebo jiný zdokumentovaný základ použití | Žádný zkontrolovaný katalog zde není zveřejněn |
| Historie zpracování | Transformace, normalizace, odstranění duplicit, agregace a případné syntetické nebo modelem vytvořené příspěvky | Označení source: dataset je neukazuje |
| Pokrytí populace | Pokrytí zemí a písem, proces výběru, definice označení a zdokumentované zkreslení | Žádné nezávisle vyhodnocené údaje o pokrytí zde nejsou zveřejněny |
| Aktuálnost | Identifikátory snímků, data aktualizací pro jednotlivé zdroje a stanovený plán aktualizací | Odpověď V2 neobsahuje údaje o aktuálnosti jednotlivých řádků ani identifikátor snímku |
| Kvalita a opravy | Výsledky validace, kontroly překryvu, postup oprav a odstraňování a odpovědnost za kontrolu | Žádné výsledky auditu pro jednotlivé zdroje zde nejsou zveřejněny |
Ochrana osobních údajů, zpracování a odpovědné použití
Původ zdrojů, zpracování osobních údajů a právní podmínky jsou různé otázky. Role při zpracování, dobu uchovávání, poskytovatele a smluvní podmínky najdete v aktuálně zveřejněných zásadách. Tento technický průvodce nepřidává žádné nové sliby ohledně uchovávání a nepotvrzuje splnění právních požadavků.
Odesílejte jen údaje, které váš postup potřebuje. Zachovejte druhy spolehlivosti i neznámé výsledky a odhad nepopisujte jako identitu, kterou osoba sama uvedla. Odvozené pohlaví nepoužívejte jako podklad pro rozhodnutí se závažnými důsledky pro jednotlivce.
Podklady o přesnosti a historie změn
Označení zdroje vysvětluje cestu odhadu, nikoli jeho naměřenou kvalitu. Průvodce přesností vám pomůže rozlišit hodnoty v odpovědi, pokrytí odpovědí, chyby a údaje potřebné pro reprodukovatelné hodnocení.
| Datum | Verze dokumentu | Změna |
|---|---|---|
| 2026-09-30 | 1.0.0 | Česká verze datovaného soupisu v MongoDB, ohraničených kontrol konzistence ve vzorcích, polí source a match ve V2, hranic zpracování pomocí AI a mezer, které v katalogu zdrojů zbývají. Shoda MongoDB a Redis vychází z potvrzení GenderAPI.io ze dne 26. září 2026; nezávislé porovnání zbývá. Nezavádí se žádné procento přesnosti ani tvrzení o licencích zdrojů. |