{
  "schema_version": "bctl-destination-api@2.0.0",
  "snapshot_id": "bctl-destinations-47f0620be1025f8fa455",
  "edition": "editorial-destination-catalog",
  "catalog_version": "2026-10-29",
  "official_results_released": false,
  "scope_notice": "An editorial research destination catalog, not a best-city ranking or official Civometra quarterly result. Projected urban-footprint context is separate from municipal statistics, reviewed guides and V1 index evidence.",
  "rights_notice": "Source acknowledgement and the original publisher terms apply. This API grants no new rights over third-party measurements. BestCityToLive owns its original editorial selection, code and derivations, not the underlying JRC or U.S. Census Bureau observations.",
  "content_sha256": "95d7a0aab2ec0b2cd02a95055a3d296db5490750ffcfc39a5785bb243af81cdb",
  "destination": {
    "id": "bctl:yokohama",
    "slug": "yokohama",
    "name": "Yokohama",
    "aliases": [],
    "country": {
      "iso2": "JP",
      "name": "Japan"
    },
    "canonical_url": "https://bestcitytolive.com/city/yokohama",
    "reference_point": {
      "longitude": 139.65361837436774,
      "latitude": 35.66458967247394,
      "role": "Publisher urban-footprint centroid transformed from ESRI:54009; contextual source point, not a separately reviewed city-center pin or municipal boundary."
    },
    "profile": {
      "kind": "evidence-profile",
      "guide_status": "guide-research-pending",
      "guide_reviewed_at": null,
      "notice": "A source-backed urban evidence profile. Local arrival, neighborhood, safety and service guidance has not been reviewed; no editorial guide date is assigned."
    },
    "source": {
      "publisher": "European Commission, Joint Research Centre",
      "dataset_name": "GHS Urban Centre Database 2025",
      "edition": "GHS-UCDB R2024A V1-2",
      "period": "2025",
      "geography_kind": "morphological-urban-centre",
      "source_crs": "ESRI:54009",
      "urban_centre_id": "5929",
      "native_name": "Tokyo",
      "constituent_names": [
        "Tokyo",
        "Yokohama",
        "Kawasaki",
        "Saitama",
        "Chiba",
        "Setagaya",
        "Ota",
        "Nerima",
        "Adachi",
        "Edogawa",
        "Funabashi",
        "Kawaguchi",
        "Itabashi",
        "Hachioji",
        "Suginami",
        "Koto",
        "Ichikawa",
        "Matsudo",
        "Katsushika",
        "Fujisawa",
        "Machida",
        "Shinagawa",
        "Kashiwa",
        "Yokosuka",
        "Kawagoe",
        "Kita",
        "Shinjuku",
        "Koshigaya",
        "Tokorozawa",
        "Nakano",
        "Toshima",
        "Meguro",
        "Sumida",
        "Ichihara",
        "Fuchu",
        "Hiratsuka",
        "Minato",
        "Soka",
        "Chigasaki",
        "Yamato",
        "Kasukabe",
        "Chofu",
        "Shibuya",
        "Bunkyo",
        "Ageo",
        "Atsugi",
        "Arakawa",
        "Taito",
        "Nishitokyo",
        "Yachiyo",
        "Kodaira",
        "Mitaka",
        "Odawara",
        "Nagareyama",
        "Tachikawa",
        "Narashino",
        "Kamakura",
        "Sakura",
        "Hino",
        "Hadano",
        "Urayasu",
        "Niiza",
        "Chuo",
        "Noda",
        "Sayama",
        "Kuki",
        "Higashimurayama",
        "Iruma",
        "Tama",
        "Asaka",
        "Musashino",
        "Koga",
        "Misato",
        "Toda",
        "Abiko",
        "Ebina",
        "Zama",
        "Kokubunji",
        "Koganei",
        "Konosu",
        "Higashikurume",
        "Fujimino",
        "Akishima",
        "Kamagaya",
        "Fujimi",
        "Toride",
        "Sakado",
        "Isehara",
        "Yotsukaido",
        "Inagi",
        "Yashio",
        "Higashiyamato",
        "Ayase",
        "Wako",
        "Akiruno",
        "Gyoda",
        "Hanno",
        "Komae",
        "Kiyose",
        "Okegawa",
        "Kunitachi",
        "Shiki",
        "Warabi",
        "Yoshikawa",
        "Musashimurayama",
        "Tsurugashima",
        "Moriya",
        "Kitamoto",
        "Shiroi",
        "Sodegaura",
        "Hasuda",
        "Fussa",
        "Zushi",
        "Hidaka",
        "Hamura",
        "Shiraoka",
        "Satte",
        "Chiyoda",
        "Minamiashigara"
      ],
      "country_labels": {
        "GADM": "Japan",
        "UN_WPP": "Japan"
      },
      "region": "Eastern and South-Eastern Asia",
      "url": "https://data.jrc.ec.europa.eu/dataset/1a338be6-7eaf-480c-9664-3a8ade88cbcd",
      "archive": {
        "url": "https://bestcitytolive.com/data/source-frames/ghsl-ucdb-general-v1_2-bc879d823205.zip",
        "sha256": "bc879d82320504f89df2041b7936221c8239cd808abe93980493aed062b4f3d6"
      },
      "geometry_wkb_sha256": "40b4b23e034f517ed5cc80202a9802516a13cac41760ab81c565a15edbbaa773",
      "native_geometry_valid": true,
      "retrieved_at": "2026-10-26",
      "centroid": {
        "longitude": 139.65361837436774,
        "latitude": 35.66458967247394
      },
      "notice": "Morphological urban centres are not municipalities or commuting functional urban areas. These contextual records are excluded from Civometra scoring.",
      "citation": "Mari Rivero et al. (2024). GHS-UCDB R2024A – GHS Urban Centre Database 2025. European Commission, JRC. doi:10.2905/1a338be6-7eaf-480c-9664-3a8ade88cbcd. V1-2.",
      "licence_notice": "European Commission reuse notice: reuse authorised with source acknowledgement; underlying third-party terms remain applicable."
    },
    "context": {
      "population": {
        "value": 33155906.87,
        "unit": "persons",
        "period": "2025",
        "kind": "publisher-projection",
        "source_field": "GC_POP_TOT_2025",
        "source_literal": "33155906.87"
      },
      "area": {
        "value": 5165,
        "unit": "km2",
        "period": "2025",
        "kind": "publisher-footprint-area",
        "source_field": "GC_UCA_KM2_2025",
        "source_literal": "5165"
      },
      "density": {
        "value": 6419.343053242982,
        "unit": "persons/km2",
        "period": "2025",
        "kind": "derived",
        "calculation": "population_projected_2025 / area_km2",
        "numerator": 33155906.87,
        "denominator": 5165
      },
      "notice": "Publisher 2025 population projection from GHS-POP R2023A and morphological urban-footprint area; density is their ratio. Not a current census count, municipal population or livability score. Shared footprints repeat one contextual measurement, not independent city estimates."
    },
    "shared_measurement": {
      "unit_id": "ghsl-ucdb-r2024a-v1-2:5929",
      "destination_ids": [
        "bctl:tokyo"
      ],
      "notice": "Repeated bindings to the same physical source footprint are not independent urban estimates."
    },
    "housing_context": null,
    "ranking": {
      "status": "not-ranked",
      "official_results_released": false
    },
    "legacy": null,
    "links": {
      "json": "https://bestcitytolive.com/api/v2/destinations/yokohama.json",
      "markdown": "https://bestcitytolive.com/api/v2/destinations/yokohama.md",
      "country": "https://bestcitytolive.com/api/v2/countries/jp.json"
    }
  }
}
