Šķîþ ţö ḿàîñ çöñţéñţ

Ç-12: Þļàçéš

Šüḿḿàŕý​

À ĝéö àẋîš (Ç-02) ĥöļđš þļàçé îđš ƒŕöḿ ţĥé þŕöĵéçţ'š ĝàžéţţééŕ. Ţĥé ĝàžéţţééŕ îš ţĥé ƃüîļţ-îñ þļàçéš, ŵĥîçĥ àŕé ţĥé ŵöŕļđ, ţĥé ÜÑ Ḿ49 ŕéĝîöñš, éṽéŕý ÎŠÖ 3166-1 çöüñţŕý àñđ éṽéŕý ÎŠÖ 3166-2 šüƃđîṽîšîöñ, þļüš ţĥé þļàçéš ţĥé ŕéçîþé đéçļàŕéš üñđéŕ places:: à çîţý, à ñéîĝĥƃöüŕĥööđ, à ḿéţŕöþöļîţàñ àŕéà, à šàļéš ţéŕŕîţöŕý. Éàçĥ þļàçé šîţš ŵîţĥîñ öñé öŕ ḿöŕé þļàçéš öŕ îš ḿàđé öƒ þļàçéš. Çöñţàîñḿéñţ îš çöḿþüţéđ ƒŕöḿ ţĥéšé ţŵö đéçļàŕàţîöñš öñļý. À ŕüļé šçöþéđ ţö Ñöŕŵàý àþþļîéš ţö çöñţéñţ àţ Öšļö ƃéçàüšé ţĥé ŕéçîþé đéçļàŕéš Öšļö ŵîţĥîñ ţĥé çöüñţý no-03, àñđ ţĥé ƃüîļţ-îñ đàţà þüţš no-03 ŵîţĥîñ Ñöŕŵàý.

core/place ĥöļđš ţĥé ĝàžéţţééŕ àñđ ţĥé çöñţàîñḿéñţ ŕüļéš öṽéŕ îţ. Ţĥé ŕéçîþé ļöàđéŕ, ţĥé àẋîš šþàçé, ţĥé öþéŕàţîöñ ļöĝ, ţĥé ţéŕḿš šţöŕé, ţĥé ĥöšţ àñđ ţĥé àţļàš àļļ çàļļ îţ. Ţĥé ḿàþ îñ @neokapi/context-atlas àþþļîéš ţĥé šàḿé ŕüļéš ţö ţĥé þļàçé ĝŕàþĥ îñ ţĥé àţļàš đöçüḿéñţ, àñđ à çöñƒöŕḿàñçé ƒîẋţüŕé ţĥàţ ţĥé Ĝö àñđ ŢýþéŠçŕîþţ ţéšţš ƃöţĥ ŕüñ ķééþš ţĥé ţŵö îḿþļéḿéñţàţîöñš îñ àĝŕééḿéñţ. À þļàçé'š šĥàþé îš üšéđ öñļý ƒöŕ đŕàŵîñĝ. Ţĥé ḿàþ đŕàŵš ƃüîļţ-îñ þļàçéš ƒŕöḿ Ñàţüŕàļ Éàŕţĥ öüţļîñéš, àñđ à đéçļàŕéđ þļàçé ƒŕöḿ ţĥé ĜéöĴŠÖÑ ƒîļé îţ ñàḿéš.

Çöñţéẋţ​

Ţĥé ḿàŕķéţš à þŕöĵéçţ ŵŕîţéš ƒöŕ öƒţéñ šþàñ šéṽéŕàļ àđḿîñîšţŕàţîṽé ļéṽéļš. À çàḿþàîĝñ çàñ ŕüñ îñ öñé çîţý àñđ öñé öƒ îţš ñéîĝĥƃöüŕĥööđš. À šàļéš ţéŕŕîţöŕý çàñ çöṽéŕ ƒîṽé çöüñţŕîéš, àñđ à đéļîṽéŕý àŕéà çàñ çöṽéŕ à ḿéţŕöþöļîţàñ àŕéà àçŕöšš ţŵö çöüñţîéš. À ŕüļé ŕéçöŕđéđ ƒöŕ öñé öƒ ţĥéšé þļàçéš ĥàš ţö àþþļý ţö çöñţéñţ ŵŕîţţéñ ƒöŕ ţĥé þļàçéš îñšîđé îţ. Ţŵö ŕüļéš ŵĥöšé þļàçéš öṽéŕļàþ ĥàṽé ţö ƃé đéţéçţéđ àš öṽéŕļàþþîñĝ.

Çöñţàîñḿéñţ çöüļđ ƃé çöḿþüţéđ ƒŕöḿ ĝéöḿéţŕý, ƃý ţéšţîñĝ ŵĥéţĥéŕ öñé öüţļîñé ļîéš îñšîđé àñöţĥéŕ. Ţĥé ŕéšüļţ ŵöüļđ ţĥéñ đéþéñđ öñ ţĥé ƃöüñđàŕý đàţà, îţš ṽéŕšîöñ àñđ šîḿþļîƒîçàţîöñ, à ĝéöḿéţŕý ļîƃŕàŕý, àñđ ţĥé þŕéšéñçé öƒ ţĥé ƒîļéš. Đéçļàŕéđ çöñţàîñḿéñţ ĝîṽéš ţĥé šàḿé ŕéšüļţ öñ éṽéŕý ḿàçĥîñé, öƒƒļîñé, ƒöŕ ţĥé çöšţ öƒ à ḿàþ ļööķüþ. Éṽéŕý çĥàñĝé ţö îţ àþþéàŕš îñ ţĥé ŕéçîþé'š đ, ŵĥéŕé à ŕéṽîéŵéŕ šééš îţ ƃéšîđé ţĥé çöñţéñţ îţ àƒƒéçţš.

Đéçîšîöñ​

Nordicsnordics · territoryGreater Oslogreater-oslo · metroWorldworld · worldEuropeeurope · regionNorthern Europenorthern-europe · regionNorwayno · countrySwedense · countryDenmarkdk · countryFinlandfi · countryIcelandis · countryOslono-03 · subdivisionAkershusno-32 · subdivisionOslooslo · localityGrünerløkkagrunerlokka · neighbourhoodsits withinmade ofdeclared in the recipe

Ţĥé þļàçéš öƒ ţĥé ĶàþîḾàŕţ šàḿþļé. Ƃüîļţ-îñ þļàçéš ƒöŕḿ à ţŕéé üñđéŕ ţĥé ŵöŕļđ; à đéçļàŕéđ þļàçé šîţš ŵîţĥîñ þļàçéš öŕ îš ḿàđé öƒ ţĥéḿ.

À þļàçé​

type Place struct {
    ID       string            // a slug, matched byte for byte: "oslo", "no-03", "no", "northern-europe", "world"
    Name     string            // English display name, from CLDR for a built-in place
    Names    map[string]string // display names per BCP 47 locale, for a declared place
    Type     Type
    Within   []string          // the places it sits inside
    Of       []string          // the places it is made of
    Refs     []string          // ids in other gazetteers: "wikidata:Q585", "geonames:3143244"
    Centroid *LatLon           // [lat, lon], for drawing
    Shape    string            // a declared place's GeoJSON file, project-relative
    Declared bool
}

À þļàçé šéţš éẋàçţļý öñé öƒ within: àñđ of:. Type îš à ñàḿéđ ķîñđ öƒ þļàçé ŕàţĥéŕ ţĥàñ à ñüḿƃéŕéđ ļéṽéļ, ƃéçàüšé àđḿîñîšţŕàţîṽé ļéṽéļš đéŕ ƃéţŵééñ çöüñţŕîéš:

ŢýþéĤöļđš
worldţĥé öñé þļàçé world
regionà ÜÑ Ḿ49 ŕéĝîöñ, šüƃŕéĝîöñ öŕ îñţéŕḿéđîàţé ŕéĝîöñ
countryàñ ÎŠÖ 3166-1 çöüñţŕý öŕ ţéŕŕîţöŕý
subdivisionàñ ÎŠÖ 3166-2 šüƃđîṽîšîöñ, ƃüîļţ îñ, öŕ đéçļàŕéđ ƒöŕ à ḿüñîçîþàļîţý ÎŠÖ 3166-2 đöéš ñöţ ļîšţ
territoryà ḿàŕķéţ öŕ šàļéš ţéŕŕîţöŕý, üšüàļļý ḿàđé öƒ þļàçéš; ţĥé đéƒàüļţ ƒöŕ à đéçļàŕéđ þļàçé ŵîţĥ of:
metroà ḿéţŕöþöļîţàñ àŕéà, üšüàļļý ḿàđé öƒ þļàçéš
localityà çîţý, ţöŵñ öŕ ṽîļļàĝé
districtà ƃöŕöüĝĥ öŕ çîţý đîšţŕîçţ
neighbourhoodà ñéîĝĥƃöüŕĥööđ ŵîţĥîñ à ļöçàļîţý öŕ đîšţŕîçţ
postal-areaţĥé àŕéà öƒ à þöšţàļ çöđé
areaàñý öţĥéŕ àŕéà; ţĥé đéƒàüļţ ƒöŕ à đéçļàŕéđ þļàçé ŵîţĥ within:

Type.Rank öŕđéŕš ţĥé ţýþéš àš ţĥé ţàƃļé ļîšţš ţĥéḿ, ŵîđéšţ ƒîŕšţ. Þļàçé ļîšţš šöŕţ ƃý îţ, šö à çöüñţŕý çöḿéš ƃéƒöŕé îţš šüƃđîṽîšîöñš.

Ñàḿéš àŕé ƒöŕ đîšþļàý. Ḿàţçĥîñĝ çöḿþàŕéš îđš öñļý, šö ŕéñàḿîñĝ à þļàçé çĥàñĝéš ñö çöñţéñţ àñđ ñö ŕüļé.

Ţĥé ƃüîļţ-îñ ĝàžéţţééŕ​

place.Builtin() îš šĥàŕéđ àñđ îḿḿüţàƃļé:

  • world, ŵĥîçĥ çöñţàîñš éṽéŕý þļàçé.
  • Ţĥé ÜÑ Ḿ49 ŕéĝîöñš, šüƃŕéĝîöñš àñđ îñţéŕḿéđîàţé ŕéĝîöñš, ƃý šļüĝ (northern-europe, sub-saharan-africa, latin-america-and-the-caribbean), éàçĥ ŵîţĥîñ ţĥé ŕéĝîöñ àƃöṽé îţ, à çöñţîñéñţ ŵîţĥîñ ţĥé ŵöŕļđ.
  • Éṽéŕý ÎŠÖ 3166-1 çöüñţŕý àñđ ţéŕŕîţöŕý, ƃý îţš àļþĥà-2 çöđé îñ ļöŵéŕ çàšé, ŵîţĥ îţš Éñĝļîšĥ šĥöŕţ ñàḿé, àñ àþþŕöẋîḿàţé çéñţŕöîđ, àñđ ţĥé Ḿ49 ŕéĝîöñ îţ šîţš îñ: ţĥé îñţéŕḿéđîàţé ŕéĝîöñ ŵĥéŕé Ḿ49 ñàḿéš öñé (ke ŵîţĥîñ eastern-africa), éļšé ţĥé šüƃŕéĝîöñ. Àñţàŕçţîçà šîţš đîŕéçţļý ŵîţĥîñ ţĥé ŵöŕļđ.
  • Éṽéŕý ÎŠÖ 3166-2 šüƃđîṽîšîöñ, ƃý îţš çöđé îñ ļöŵéŕ çàšé ŵîţĥ ţĥé ĥýþĥéñ (no-03, us-ca, gb-sct), ŵîţĥ îţš Éñĝļîšĥ ñàḿé àñđ ţĥé þļàçé îţ šîţš îñ, îñçļüđîñĝ šéçöñđ ļéṽéļš: fr-69m šîţš ŵîţĥîñ ţĥé ŕéĝîöñ fr-ara, ŵĥîçĥ šîţš ŵîţĥîñ fr.

Ţĥé šüƃđîṽîšîöñš çöḿé ƒŕöḿ Üñîçöđé ÇĻĐŔ àţ à þîññéđ ŕéļéàšé (release-48-2): common/validity/subdivision.xml ƒöŕ ţĥé îđš ÇĻĐŔ ḿàŕķš ŕéĝüļàŕ, common/supplemental/subdivisions.xml ƒöŕ çöñţàîñḿéñţ, àñđ common/subdivisions/en.xml ƒöŕ ţĥé ñàḿéš. ÎŠÖ 3166-2 çĥàñĝéš ţĥàţ ţĥé þîññéđ ŕéļéàšé đöéš ñöţ ŕéçöŕđ ýéţ àŕé ļîšţéđ îñ core/place/internal/gen/amendments.tsv, öñé ļîñé þéŕ àđđéđ öŕ ŕéţîŕéđ îđ, éàçĥ ñàḿîñĝ îţš šöüŕçé. Ţĥé ĝéñéŕàţöŕ (go generate ./core/place) đöŵñļöàđš ţĥé ţĥŕéé ƒîļéš, àþþļîéš ţĥé àḿéñđḿéñţš, àñđ ŵŕîţéš core/place/subdivisions.tsv, ŵĥîçĥ îš çöḿḿîţţéđ àñđ éḿƃéđđéđ. Ţĥé ĝéñéŕàţöŕ ƒàîļš öñ àñ àḿéñđḿéñţ ţĥàţ ţĥé þîññéđ ŕéļéàšé àļŕéàđý çöñţàîñš, šö à ŕéļéàšé ƃüḿþ àļšö ŕéḿöṽéš ţĥàţ àḿéñđḿéñţ ļîñé. Ţĥé ÇĻĐŔ đàţà îš üñđéŕ ţĥé Üñîçöđé Ļîçéñšé ṽ3, ŵĥîçĥ šĥîþš ƃéšîđé îţ àš core/place/UNICODE-LICENSE.txt. Ţĥé ƒîļé ĥàš ţĥàţ ñàḿé ƃéçàüšé à ƒîļé ñàḿéđ LICENSE ḿàŕķš à ļîçéñçé ƃöüñđàŕý îñ ţĥîš ŕéþöšîţöŕý.

Éṽéŕý ƃüîļţ-îñ þļàçé éẋçéþţ ţĥé ŵöŕļđ šîţš ŵîţĥîñ éẋàçţļý öñé þļàçé, šö ţĥé ƃüîļţ-îñ þļàçéš ƒöŕḿ à ţŕéé. À ţéšţ çĥéçķš ţĥé đàţà: ţĥé ƒîļé þàŕšéš, îđš àŕé üñîǫüé, éṽéŕý þàŕéñţ ŕéšöļṽéš, àñđ ñö šüƃđîṽîšîöñ îđ çöļļîđéš ŵîţĥ à ŕéĝîöñ šļüĝ öŕ à çöüñţŕý çöđé.

Đéçļàŕéđ þļàçéš​

À ŕéçîþé àđđš þļàçéš üñđéŕ ţĥé ţöþ-ļéṽéļ places: ķéý, ƃéšîđé axes::

places:
  oslo:
    name: Oslo
    type: locality
    within: no-03                     # one id or a list
    centroid: [59.91, 10.75]
    refs: [wikidata:Q585, geonames:3143244]
  grunerlokka:
    name: Grünerløkka
    type: neighbourhood
    within: oslo
  nordics:
    name: Nordics
    of: [no, se, dk, fi, is]          # type defaults to territory
  greater-oslo:
    name: Greater Oslo
    type: metro
    of: [no-03, no-32]

axes:
  market:
    kind: geo
    label: Market

place.New(declared) ƃüîļđš ţĥé þŕöĵéçţ'š ĝàžéţţééŕ öñ ţöþ öƒ ţĥé ƃüîļţ-îñ öñé àñđ ṽàļîđàţéš éṽéŕý đéçļàŕéđ þļàçé. Éàçĥ éŕŕöŕ ñàḿéš ţĥé ŕéçîþé ķéý (places.<id>...). Ţĥé ŕüļéš àŕé:

  • ţĥé îđ îš à šļüĝ ţĥàţ ñö ƃüîļţ-îñ þļàçé üšéš;
  • ţĥé þļàçé šéţš within: öŕ of:, àñđ ñöţ ƃöţĥ;
  • éṽéŕý îđ îţ ļîšţš îš à þļàçé;
  • ñö çĥàîñ öƒ within: àñđ of: ļéàđš ƒŕöḿ à þļàçé ƃàçķ ţö îţšéļƒ;
  • ţĥé ţýþé îš öñé à ŕéçîþé ḿàý đéçļàŕé;
  • names àŕé ķéýéđ ƃý ļöçàļé;
  • refs üšé à ķñöŵñ šçĥéḿé (wikidata, geonames, nuts, osm, wof), ŵîţĥ à ṽàļüé îñ ţĥàţ šçĥéḿé'š ƒöŕḿàţ;
  • ţĥé çéñţŕöîđ îš à ṽàļîđ ļàţîţüđé àñđ ļöñĝîţüđé;
  • shape îš à .geojson öŕ .json þàţĥ ŕéļàţîṽé ţö ţĥé þŕöĵéçţ àñđ îñšîđé îţ.

Ţĥé ŕéçîþé ļöàđ ţĥéñ çĥéçķš ţĥàţ ţĥé šĥàþé ƒîļé éẋîšţš. Ţĥé þŕöĵéçţ ƒîļé ŕéƒéŕéñçé ļîšţš ţĥé éŕŕöŕ ḿéššàĝéš.

KapiProject.Gazetteer() ŕéţüŕñš ţĥé ĝàžéţţééŕ ƃüîļţ àţ ļöàđ, àñđ KapiProject.AxisSpace() îš axis.NewSpace(p.Axes, p.Gazetteer()), šö éṽéŕý çàļļéŕ ţĥàţ îñţéŕþŕéţš à çööŕđîñàţé üšéš ţĥé þŕöĵéçţ'š þļàçéš.

Çöñţàîñḿéñţ àñđ öṽéŕļàþ​

Gazetteer.Contains(outer, inner) àþþļîéš ţĥéšé ŕüļéš ţö ţĥé đéçļàŕàţîöñš:

  • éṽéŕý ñöñ-éḿþţý îđ çöñţàîñš îţšéļƒ, ķñöŵñ öŕ ñöţ;
  • ţĥé ŵöŕļđ çöñţàîñš éṽéŕý ķñöŵñ þļàçé;
  • à þļàçé ḿàđé öƒ þļàçéš šîţš ŵîţĥîñ outer ŵĥéñ éṽéŕý öñé öƒ îţš ḿéḿƃéŕš đöéš;
  • à þļàçé ḿàđé öƒ þļàçéš çöñţàîñš inner ŵĥéñ öñé öƒ îţš ḿéḿƃéŕš çöñţàîñš îţ, öŕ ŵĥéñ inner îš đéçļàŕéđ ŵîţĥîñ îţ;
  • öţĥéŕŵîšé inner šîţš ŵîţĥîñ outer ŵĥéñ öñé öƒ ţĥé þļàçéš îţ šîţš ŵîţĥîñ đöéš.

Àñ îđ ţĥàţ îš ñöţ îñ ţĥé ĝàžéţţééŕ çöñţàîñš öñļý îţšéļƒ àñđ šîţš ŵîţĥîñ öñļý îţšéļƒ. À ŕüļé ŕéçöŕđéđ àţ à þļàçé ţĥàţ àñöţĥéŕ çĥéçķöüţ đéçļàŕéš ţĥéŕéƒöŕé šţîļļ àþþļîéš ţö çöñţéñţ àţ ţĥàţ šàḿé îđ, àñđ ţö ñö öţĥéŕ þļàçé.

Gazetteer.Overlaps(a, b) îš ţŕüé ŵĥéñ öñé þļàçé çöñţàîñš ţĥé öţĥéŕ, ŵĥéñ à ḿéḿƃéŕ öƒ à þļàçé ḿàđé öƒ þļàçéš öṽéŕļàþš ţĥé öţĥéŕ þļàçé, öŕ ŵĥéñ à đéçļàŕéđ þļàçé šîţš ŵîţĥîñ ƃöţĥ. Ţĥé ƃüîļţ-îñ þļàçéš ƒöŕḿ à ţŕéé, šö ţŵö ƃüîļţ-îñ þļàçéš öṽéŕļàþ öñļý ŵĥéñ öñé çöñţàîñš ţĥé öţĥéŕ. Öñļý à đéçļàŕéđ þļàçé ŵîţĥ šéṽéŕàļ within: þàŕéñţš çöññéçţš ţŵö ƃŕàñçĥéš. Šüĝĝéšţîöñš àţ greater-oslo àñđ àţ oslo öṽéŕļàþ, àñđ šö đö šüĝĝéšţîöñš àţ nordics àñđ àţ no-03. Šüĝĝéšţîöñš àţ oslo àñđ àţ bergen đö ñöţ.

Ƒöŕ à ĝéö àẋîš, axis.Space.Contains àñđ axis.Space.Overlaps çàļļ ţĥéšé ţŵö ƒüñçţîöñš. Šçöþé çöṽéŕàĝé öƒ à þöîñţ (Ç-11), ţĥé ţéŕḿš-šţöŕé ḿàţçĥ öƒ à çöñçéþţ àţ à þöîñţ (terms.AtPointIn) àñđ ţĥé öṽéŕļàþ ţéšţ ƃéţŵééñ ŕéçöŕđš îñ ţĥé öþéŕàţîöñ ļöĝ'š ƒöļđ àļļ ĝö ţĥŕöüĝĥ ţĥéḿ.

Þàţĥš, àñçéšţöŕš àñđ çĥîļđŕéñ​

À šüŕƒàçé ţĥàţ šĥöŵš à þļàçé îñ çöñţéẋţ ñééđš à šîñĝļé çĥàîñ ƒŕöḿ ţĥé ŵöŕļđ đöŵñ ţö îţ. Gazetteer.Path(id) ƒöļļöŵš éàçĥ þļàçé'š ƒîŕšţ within: þàŕéñţ. Ƒöŕ à þļàçé ḿàđé öƒ þļàçéš, ţĥé þàŕéñţ îš ţĥé ñéàŕéšţ þļàçé öñ îţš ƒîŕšţ ḿéḿƃéŕ'š þàţĥ ţĥàţ çöñţàîñš éṽéŕý ḿéḿƃéŕ: northern-europe ƒöŕ nordics, àñđ no ƒöŕ greater-oslo. Path("grunerlokka") îš [world europe northern-europe no no-03 oslo grunerlokka] àñđ Path("nordics") îš [world europe northern-europe nordics].

Ancestors(id) ļîšţš éṽéŕý þļàçé ţĥàţ çöñţàîñš id, ñéàŕéšţ ƒîŕšţ, îñçļüđîñĝ éàçĥ þļàçé ḿàđé öƒ þļàçéš ţĥàţ çöñţàîñš îţ. Children(id) ļîšţš ţĥé þļàçéš ŵĥöšé þàţĥ þàŕéñţ îš id, þļüš ţĥé ḿéḿƃéŕš ŵĥéñ id îš à þļàçé ḿàđé öƒ þļàçéš, šöŕţéđ ƃý ñàḿé. Ţĥé àţļàš üšéš ţĥéšé ţö çöļļéçţ ţĥé þļàçéš à ḿàþ çàñ đŕîļļ îñţö.

Ļööķîñĝ à þļàçé üþ​

Gazetteer.Search(query, limit) ḿàţçĥéš þļàçéš ŵĥöšé îđ šţàŕţš ŵîţĥ ţĥé ǫüéŕý, ţĥéñ þļàçéš ŵĥöšé ñàḿé šţàŕţš ŵîţĥ îţ, ţĥéñ þļàçéš ŵĥöšé ñàḿé çöñţàîñš îţ. Îţ îĝñöŕéš çàšé àñđ àççéñţš, šö grunerlokka ƒîñđš Ĝŕüñéŕļøķķà, àñđ à đéçļàŕéđ þļàçé'š ñàḿéš îñ öţĥéŕ ļöçàļéš çöüñţ àš ñàḿéš. Ŵîţĥîñ éàçĥ ţîéŕ ţĥé éẋàçţ îđ çöḿéš ƒîŕšţ, ţĥéñ ŵîđéŕ ķîñđš öƒ þļàçé, ţĥéñ îđš îñ öŕđéŕ.

À þéŕšöñ öŕ àñ àĝéñţ ļööķš üþ àñ îđ ŵîţĥ kapi context places [query] [--within <id>] (host.App.ContextPlaces). Ŵîţĥ à ǫüéŕý, ţĥé çöḿḿàñđ ļîšţš ţĥé ḿàţçĥéš, ļîḿîţéđ ţö þļàçéš îñšîđé --within ŵĥéñ îţ îš ĝîṽéñ. Ŵîţĥ öñļý --within, îţ ļîšţš ţĥé þļàçéš đîŕéçţļý ƃéļöŵ ţĥàţ þļàçé. Ŵîţĥ ñéîţĥéŕ, îţ ļîšţš ţĥé đéçļàŕéđ þļàçéš. Éàçĥ ļîñé ĝîṽéš ţĥé îđ, ţĥé ñàḿé, ţĥé ţýþé àñđ ţĥé þàţĥ. ΃ à çööŕđîñàţé ṽàļüé îš ñöţ à þļàçé îđ, ţĥé ŕéçîþé ƒàîļš ţö ļöàđ àñđ ţĥé éŕŕöŕ çàŕŕîéš à ĥîñţ ƒŕöḿ place.Hint. Ţĥé ĥîñţ îš ţĥé ļöŵéŕ-çàšé öŕ ĥýþĥéñàţéđ šþéļļîñĝ ŵĥéñ ţĥàţ îš à þļàçé îđ, öţĥéŕŵîšé üþ ţö ţĥŕéé ḿàţçĥéš àñđ ţĥé kapi context places çöḿḿàñđ ƒöŕ ƒîñđîñĝ ḿöŕé.

À ļöçàļé çàñ ñàḿé à þļàçé​

place.OfLocale(tag) ŕéţüŕñš ţĥé þļàçé à ļöçàļé ţàĝ îđéñţîƒîéš. Ţĥàţ îš ţĥé šüƃđîṽîšîöñ îñ à -u-sd- éẋţéñšîöñ (nb-NO-u-sd-no03 îš no-03), éļšé ţĥé çöüñţŕý öŕ Ḿ49 ŕéĝîöñ öƒ ţĥé ŕéĝîöñ šüƃţàĝ (fr-CA îš ca, es-419 îš latin-america-and-the-caribbean). À ţàĝ ŵîţĥ ñéîţĥéŕ ŕéţüŕñš ñö þļàçé. Ţĥé àţļàš üšéš îţ ţö đéŕîṽé ţĥé region àẋîš öƒ éṽéŕý ŕéçöŕđ ţĥàţ ĥàš à ļöçàļé. À ŕéçîþé'š target_languages ḿàý üšé ţĥé -u-sd- éẋţéñšîöñ.

Ţĥé šàḿé ŕüļéš îñ Ĝö àñđ ŢýþéŠçŕîþţ​

Ţĥé ḿàþ ƒîļţéŕš àñđ çöüñţš îñ ţĥé ƃŕöŵšéŕ, šö @neokapi/context-atlas îḿþļéḿéñţš ţĥé šàḿé ŕüļéš öṽéŕ ţĥé àţļàš'š places (placeIndex îñ model/places.ts: contains, overlaps, path, children). core/place/testdata/containment.json îš à šḿàļļ ĝàžéţţééŕ ŵîţĥ ţĥé çàšéš ƒöŕ çöñţàîñḿéñţ, öṽéŕļàþ àñđ þàţĥš. Ţĥé Ĝö ţéšţ àñđ ţĥé ŢýþéŠçŕîþţ ţéšţ ƃöţĥ ŕüñ éṽéŕý çàšé, àñđ ţĥé Ĝö ţéšţ àļšö çĥéçķš ţĥàţ éàçĥ ƃüîļţ-îñ þļàçé îñ ţĥé ƒîẋţüŕé ḿàţçĥéš ţĥé ƃüîļţ-îñ ĝàžéţţééŕ'š îđ, ţýþé àñđ þàŕéñţ. À çĥàñĝé ţö ţĥé ŕüļéš üþđàţéš ƃöţĥ îḿþļéḿéñţàţîöñš àñđ ţĥé ƒîẋţüŕé îñ ţĥé šàḿé çöḿḿîţ.

Đŕàŵîñĝ à þļàçé​

Ţĥé àţļàš đöçüḿéñţ çàŕŕîéš ţĥé þļàçéš à ḿàþ ñééđš (Çöñţéẋţ àţļàš): éṽéŕý þļàçé à ŕéçöŕđ ñàḿéš, éṽéŕýţĥîñĝ ţĥàţ çöñţàîñš ţĥéḿ, ţĥé ḿéḿƃéŕš öƒ éàçĥ þļàçé ḿàđé öƒ þļàçéš, ţĥé đéçļàŕéđ þļàçéš, àñđ ţĥé çĥîļđŕéñ öƒ éàçĥ çöüñţŕý àñđ šüƃđîṽîšîöñ îñ ţĥàţ šéţ. À đéçļàŕéđ þļàçé ŵîţĥ à shape: çàŕŕîéš îţš öüţļîñé àš ĜéöĴŠÖÑ ĝéöḿéţŕý. ΃ ţĥé šĥàþé ƒîļé çàññöţ ƃé ŕéàđ, îš ñöţ à šîñĝļé Þöļýĝöñ öŕ ḾüļţîÞöļýĝöñ, öŕ îš ļàŕĝéŕ ţĥàñ 1 ḾîƂ, ţĥé öüţļîñé îš öḿîţţéđ àñđ ţĥé àţļàš àđđš à ñöţé ñàḿîñĝ ţĥé ŕéçîþé ķéý.

Ţĥé ƃüîļţ-îñ öüţļîñéš šĥîþ îñ @neokapi/context-atlas (src/geo/): Ñàţüŕàļ Éàŕţĥ (þüƃļîç đöḿàîñ) àţ à þîññéđ ŕéļéàšé, ţĥé àđḿîñ-0 çöüñţŕîéš îñ öñé ƒîļé àñđ éàçĥ çöüñţŕý'š àđḿîñ-1 šüƃđîṽîšîöñš îñ à ƒîļé öƒ îţš öŵñ, ķéýéđ ƃý þļàçé îđ àñđ ļöàđéđ ŵĥéñ ţĥé ḿàþ đŕîļļš îñţö ţĥàţ çöüñţŕý. À šçŕîþţ ƒéţçĥéš ţĥé þîññéđ ƒîļéš, çĥéçķš ţĥéîŕ ŠĤÀ-256 đîĝéšţš àñđ ŵŕîţéš ţĥé ŢöþöĴŠÖÑ (vp run @neokapi/context-atlas#build-geometry). Ŵĥéŕé Ñàţüŕàļ Éàŕţĥ çàŕŕîéš à šüƃđîṽîšîöñ üñđéŕ àñ öļđéŕ çöđé, öŕ öñļý àš ţĥé þàŕţš öƒ à çüŕŕéñţ öñé, scripts/geometry-successors.json çöḿþöšéš ţĥé çüŕŕéñţ îđ ƒŕöḿ ţĥöšé þàŕţš àñđ çîţéš ţĥé šöüŕçé öƒ éàçĥ ŕöŵ: ţĥé ƃöüñđàŕý öŕ çöđé çĥàñĝé, öŕ ţĥé þàŕéñţ ŕéļàţîöñ. Ţĥé þàçķàĝé'š src/geo/README.md ļîšţš ţĥé šöüŕçéš, ţĥé ļîçéñçé àñđ ţĥé îđš ţĥàţ ĥàṽé ñö öüţļîñé.

Ţĥé ḿàþ đŕàŵš à đéçļàŕéđ þļàçé ƒŕöḿ îţš ĝéöḿéţŕý, éļšé àš à çîŕçļé àţ îţš çéñţŕöîđ, éļšé ļîšţš îţ ƃéšîđé ţĥé ḿàþ. Îţ ƒļàĝš à đéçļàŕéđ þļàçé ŵĥöšé çéñţŕöîđ ƒàļļš öüţšîđé ţĥé öüţļîñé öƒ ţĥé þļàçé îţ šîţš ŵîţĥîñ, ŵĥîçĥ üšüàļļý ḿéàñš ţĥé within: îš ŵŕöñĝ. Đŕàŵîñĝ ĥàš ñö 郃éçţ öñ çöñţàîñḿéñţ.

Çöñšéǫüéñçéš​

  • À þŕöĵéçţ ñàḿéš îţš öŵñ ḿàŕķéţš àţ àñý ĝŕàîñ, ƒŕöḿ à ñéîĝĥƃöüŕĥööđ ţö à šàļéš ţéŕŕîţöŕý, àñđ à ŕüļé ķéþţ ƒöŕ à ŵîđéŕ þļàçé ĥöļđš îñ éṽéŕý þļàçé îñšîđé îţ ŵîţĥöüţ à çöþý þéŕ þļàçé.
  • Çöñţàîñḿéñţ đéþéñđš öñļý öñ ţĥé ŕéçîþé àñđ ţĥé þîññéđ đàţà, šö îţ ĝîṽéš ţĥé šàḿé ŕéšüļţ öñ éṽéŕý ḿàçĥîñé àñđ îñ éṽéŕý šüŕƒàçé, ŵîţĥ öŕ ŵîţĥöüţ öüţļîñé ƒîļéš.
  • À ŵŕöñĝ within: çĥàñĝéš ŵĥéŕé ŕüļéš àþþļý. Ţĥé çĥàñĝé àþþéàŕš îñ ţĥé ŕéçîþé'š đ, àñđ ţĥé ḿàþ ƒļàĝš à çéñţŕöîđ öüţšîđé îţš þàŕéñţ.
  • Üþđàţîñĝ ţĥé ƃüîļţ-îñ šüƃđîṽîšîöñš îš à ŕéṽîéŵéđ çĥàñĝé ţö ţĥé ĝéñéŕàţöŕ'š þîññéđ ŕéļéàšé àñđ ţĥé àḿéñđḿéñţš ƒîļé. Ţĥé đ öƒ ţĥé ĝéñéŕàţéđ ţàƃļé ļîšţš éàçĥ çĥàñĝéđ îđ.
  • Ţĥé ḿàþ'š öüţļîñéš ļàĝ ÎŠÖ 3166-2 ŵĥéŕéṽéŕ Ñàţüŕàļ Éàŕţĥ đöéš. Ţĥé ḿàþ ļîšţš à þļàçé ŵîţĥöüţ àñ öüţļîñé îñšţéàđ öƒ đŕàŵîñĝ îţ. Çöñţàîñḿéñţ îš üñàƒƒéçţéđ.

Šéé àļšö​