The pages are in English; this contents, the search and the buttons are in Japanese.

The catalogue

日本語 · English

Every venue the package draws today, the ones being built and the ones we want, in one list with ids, names in English and Japanese, places, sports and Wikidata items. It is published two ways, with the same data: a static file, catalogue.json, at a stable address and inside the npm package, and the typed entry @johnmorrisdotca/kyogijo-stadiums/catalogue. There is no server. The demo's catalogue page shows it as cards with a map, and the real stadiums and real venues pages say how a venue is drawn in its building.

• Supported: every real venue the package draws, made from its own data and never typed again: the real stadiums (STADIUMS) and the NHL's real venues (VENUES) are drawn in their buildings, inside the outline OpenStreetMap maps with a bowl of their seats; every other key of PARKS, GROUNDS, ARENAS and HALLS is drawn as a field, court, rink, park or floor only, at the venue's own size where the data gives one.
• Working on: the ten tennis show courts of ticket KYOGIJO-STADIUMS-22, open to an outside contributor.
• Wanted: every venue of the NFL and the CFL this season that is not drawn yet, and groups of world-class venues of sports the package draws (soccer, cricket, rugby, Gaelic and Australian football, sumo and the budō, athletics, college football, baseball, skating and swimming, indoor sports), each in order of how famous it is; and the circuits of Formula One's 2026 calendar and other great circuits, each of which waits for its track's data (the Las Vegas Strip Circuit is drawn already, and is supported). A venue the package draws as a field only that a league or a group lists is wanted for its building's outline, and is not listed twice.

Using it#

The JSON is at https://johnmorrisdotca.github.io/kyogijo-stadiums/catalogue.json (published with the demo) and in the package as @johnmorrisdotca/kyogijo-stadiums/catalogue.json. It has a schemaVersion (1; a change that breaks a reader raises it), generatedAt (the day the sources were read, not the day the file was written), the package's version, the licence of the facts, the counts, the sports and groups with their names in both languages, the countries' names, and venues, one object per venue.

const catalogue = await (await fetch("https://johnmorrisdotca.github.io/kyogijo-stadiums/catalogue.json")).json();
const wanted = catalogue.venues.filter((venue) => venue.status === "wanted");
console.log(catalogue.schemaVersion, wanted.length);

The entry has the same data with its types, and a few lookups:

import { CATALOGUE, catalogueById, catalogueBySport, catalogueByStatus, catalogueCoverage } from "@johnmorrisdotca/kyogijo-stadiums/catalogue";
import { drawKyogijo } from "@johnmorrisdotca/kyogijo-stadiums";

console.log(catalogueByStatus("supported").length + catalogueByStatus("working-on").length + catalogueByStatus("wanted").length === CATALOGUE.length);
// true
const nfl = catalogueCoverage("nfl");
console.log(`NFL: ${nfl.outline} of ${nfl.venues} drawn in its building, ${nfl.surface} as a field only, ${nfl.notYet} not yet`);
// NFL: 2 of 30 drawn in its building, 9 as a field only, 19 not yet
const lambeau = catalogueById("lambeau-field")!;
console.log(lambeau.status, lambeau.nameJa, lambeau.teams?.map((team) => team.name).join());
// wanted ランボー・フィールド Green Bay Packers
const fenway = catalogueById("fenway-park")!;
console.log(fenway.drawn, fenway.want, drawKyogijo({ ...fenway.draw!, style: "none" }).startsWith("<svg"));
// surface outline true
console.log(catalogueBySport("motor-racing").filter((venue) => venue.status === "supported").map((venue) => `${venue.id} ${venue.drawn}`).join());
// las-vegas circuit

A venue (CatalogueEntry) has:

The leagues#

Every venue of the season of five leagues of North America is listed, whether it is drawn or not. A stadium two clubs share is listed once, with both (MetLife Stadium, SoFi Stadium). NBA, MLB and NHL venues are the package's own (ARENAS, PARKS and VENUES, with their clubs); the NFL's and the CFL's that it does not draw are checked against the English Wikipedia's list of the league's stadiums, at the revision in source.articles.

NBA arenas: 12 of 30 drawn in its building#

MLB ballparks: 3 of 30 drawn in its building#

NFL stadiums: 2 of 30 drawn in its building#

CFL stadiums: 1 of 9 drawn in its building#

NHL arenas: 32 of 32 drawn in its building#

Supported#

By the first sport each venue is drawn for. A venue of the past is drawn as it was (its fence, its rink).

Baseball (94)#

Soccer (64)#

Budō and sumo (5)#

Ice hockey (90)#

Basketball (77)#

Boxing (1)#

Motor racing (1)#

Working on#

The four Grand Slams' show courts and Tokyo's, ticket KYOGIJO-STADIUMS-22: drawn in their buildings when they are done.

Wanted#

By group, in order of how famous each venue is. "The building's outline" is a venue the package already draws as a field; "the venue" is one it does not draw yet.

World soccer (10)#

Cricket grounds (10)#

Rugby (8)#

Gaelic and Australian football (4)#

Sumo and budō halls of Japan (6)#

Olympic stadiums and athletics (8)#

College football (7)#

Baseball around the world (4)#

Ovals and pools (7)#

Great indoor halls (5)#

Formula One, the 2026 calendar (23)#

More great circuits (29)#

What a circuit needs#

The circuits entry draws a circuit as OpenStreetMap maps it, the lap at the track's width with its pit lane and no stands: the Las Vegas Strip Circuit is the first, so it is supported (drawn: "circuit", the id and the names CIRCUITS's own; drawCircuit({ circuit: "las-vegas" }) draws it, circuits). Every other circuit waits for its own data (needs: "circuit-surface"): the circuit's relation in OpenStreetMap (its lap, pit lane, start and finish and, where they are mapped, its turns' numbers), geometry under the ODbL that is kept apart from every other file with its credit, fetched once and kept dated in data-sources/circuits/, and its length and corners checked against what the circuit's article publishes. Adding the next circuit says how.

Sources and licences#

• Wikidata, CC0: every item, the names in English and Japanese, the coordinates, the countries, the capacities and the places a venue is located in (P131, which the city is checked against).
• English Wikipedia, CC BY-SA 4.0: the title of each new venue's article (its everyday name), and, as evidence only, which venues a league's list and a season's calendar link from their tables: the NFL's and the CFL's lists of stadiums, the calendars of Formula One and MotoGP for 2026. No text of an article is copied.
• The package's own data for every supported venue: see NOTICE.md.
• pnpm catalogue:fetch keeps the raw answers, dated, in data-sources/catalogue/ (one request at a time, three seconds apart, with a User-Agent that names the package). pnpm catalogue makes src/catalogue.data.ts, catalogue.json and this page's tables from them; do not edit the tables by hand. A test holds every item to the raw answers, the JSON to the entry and these tables to the data.

Limits#

• A city is given only where Wikidata's places agree with it (or, for a league's or a calendar's venue, the article's row does); where they do not, it is left out and missing.city says why. The same holds for a name in Japanese, a country and coordinates.
• A capacity is Wikidata's when it gives one figure: a stadium's seats change with its configuration, so read it as a guide.
• The wanted groups are a choice of famous venues, not a ranking anyone published.

Edit this page on GitHub