Data & credits

Soupmap is built on open data, open-source software and a few commercial map services. Each one is listed here with its license and the exact attribution it asks for. If a source isn't on this page, we don't use it.

Where shop data comes from

Download the open-data catalog (gzip JSON). Each record includes its Overture ID and source licenses. This is a catalog of reported locations, not a complete or independently verified directory.

We list 31809 shops. Locations: 31809 seeded from Overture Maps Places, 0 from OpenStreetMap, 0 entered by hand. None have been verified on the ground so far, and every card says so.

No shop record is derived from OpenStreetMap. OSM data (ODbL) is used only as review leads.

Shop selection is editorial. We sometimes consult well-known guides to decide which names to include, but we never copy their text, ratings, photos or data, and we don't scrape Tabelog or Google Maps. Blurbs are written by us. Broth-style background is paraphrased from Wikipedia.

Map terms

The 3D map and Street View come from Google Maps Platform. By using them you agree to the Google Terms of Service and the Google Maps/Google Earth Additional Terms of Service, and the Google Privacy Policy applies to Google's part of the service.

3D map & building data

Project PLATEAU 3D city models (building 3D Tiles) 3D都市モデル(Project PLATEAU)

Live

Ministry of Land, Infrastructure, Transport and Tourism (MLIT), Japan

Used for
“Building info” mode: building usage, year built, height, storeys and hazard attributes.
License
CC BY 4.0
Attribution
出典:国土交通省 Project PLATEAU
Last checked
  • PLATEAU building data is multi-licensed (CC BY 4.0 / ODbL / ODC-BY). We use it under CC BY 4.0.
  • We restyle the buildings (near-invisible, amber highlight on the picked one). That is a modification under CC BY 4.0, which this note discloses.
  • PLATEAU streaming is a trial service with no SLA. Every request times out after 8 s and fails quietly.

PLATEAU data catalog API PLATEAU データカタログAPI

Build time

MLIT Project PLATEAU

Used for
Finding each shop city's building tileset URL (scripts/fetch-plateau-catalog.ts).
License
CC BY 4.0
Attribution
出典:国土交通省 Project PLATEAU
Last checked
  • The schema may change without notice; the script keeps the last good snapshot if the API is down.

Imagery & basemaps

PLATEAU-Ortho aerial imagery PLATEAU-Ortho(オルソ画像)

Fallback

MLIT Project PLATEAU

Used for
Ground imagery in “Data view” (the clean PLATEAU-only building view).
License
CC BY 4.0
Attribution
国土交通省 Project PLATEAU
Last checked
  • Zoom levels 10–19, covering PLATEAU cities only. Built on GSI tiles with newer aerial photos.

GSI Tiles: seamless aerial photos 地理院タイル 全国最新写真(シームレス)

Fallback

Geospatial Information Authority of Japan (GSI)

Used for
Fallback globe imagery when Google 3D tiles are unavailable.
License
GSI Content Terms of Use (compatible with CC BY 4.0)
Attribution
国土地理院
Last checked
  • No application is needed for live tile use, but the credit is required.
  • If the map becomes the site's main content, GSI may require an application. That's why GSI is our fallback only.

Recipe photographs (Wikimedia Commons)

Live

Individual photographers on Wikimedia Commons

Used for
Photographs on recipe cards and detail pages. Each photo's author, licence and file page are credited beside the image.
License
Per photo: CC0, public domain, CC BY or CC BY-SA (never NC or ND)
Attribution
Photographers credited on each recipe, via Wikimedia Commons
Last checked
  • scripts/fetch-recipe-photos.ts reads the licence from the Commons API, refuses anything that isn't CC0, public domain, CC BY or CC BY-SA, and records author, licence and file page in src/data/recipe-photos.json.
  • Photos are resized copies hosted with the site; CC BY-SA photos stay under CC BY-SA.
  • Photos are selected by hand, verified against each file's current Commons licence and downloaded as local responsive copies. No stock or generated food photos are used.

Shop discovery data

Overture Maps Places

Leads only

Overture Maps Foundation

Used for
Japan-wide soup and noodle-shop catalog and discovery leads (release 2026-09-23.1). Open-data records are not independently verified recommendations.
License
CDLA Permissive 2.0 (seeded records); some Places sources use other licenses, e.g. Apache 2.0
Attribution
© Overture Maps Foundation
Last checked
  • Each Places record lists its own sources[].dataset and license. The discovery script keeps both.
  • Shops seeded from Overture carry dataSource "overture" and the Overture ID in sourceId.
  • Addresses, postcodes, phone numbers, websites and social links shown on shop cards are copied from the source record (aggregator and review-site links are dropped). They may be out of date.
  • Derived during import, with provenance shown in the interface: prefecture (from the record's region, address or postcode prefix, else its nearest neighbours), bowl style (only when the shop's own name says it, e.g. 味噌 or 家系), chain (the same brand at 6+ locations in 3+ municipalities) and English names (chain brand names we know, otherwise an approximate reading).
  • Records with an Overture confidence below 0.3 are left out as likely closed or duplicated.

OpenStreetMap data via Overpass API

Leads only

OpenStreetMap contributors

Used for
Secondary lead source for the review queue. The expanded published catalog uses Overture, not OSM.
License
ODbL 1.0
Attribution
© OpenStreetMap contributors
Last checked
  • ODbL is share-alike. If a shop record is copied substantially from OSM, it gets dataSource "osm", and our shop dataset becomes a derivative database under ODbL.
  • Our editorial content (blurbs, videos, photos) stays ours either way.

Reference

Wikidata historical place metadata

Build time

Wikidata contributors

Used for
Curated Tokyo landmark identities, coordinates and explicitly qualified dates. No runtime Wikidata queries.
License
CC0 1.0 (structured data)
Attribution
Wikidata contributors
Last checked
  • Per-place evidence and check dates are in the optional history snapshot. Unreferenced or conflicting dates are labelled, not silently reconciled. Images are not reused.

Wikipedia historical context

Build time

Wikipedia contributors

Used for
Short attributed, adapted historical summaries, currently Ebisu, with a checked permanent revision link.
License
CC BY-SA 4.0 (adapted summaries)
Attribution
Wikipedia contributors; adapted and shortened by Soupmap; adapted summaries available under CC BY-SA 4.0
Last checked
  • Article title, permanent revision, modification notice and license accompany each adaptation. Share-alike applies to the adapted summary, not unrelated shop data. No Wikipedia or Commons images are included.

Tokyo official heritage and site histories

Build time

Tokyo Convention & Visitors Bureau; Ministry of the Environment; Sensoji; Meiji Jingu

Used for
Fact-checked original Soupmap descriptions and qualified dates, linked to each site's evidence.
License
Facts only; source prose and images not reproduced
Attribution
Historical facts: GO TOKYO and the official institutions linked in each history entry; original wording by Soupmap
Last checked
  • Source text and images remain with their rightsholders. History is independent of PLATEAU physical building facts and never inferred from Google imagery. The curated pilot is incomplete.

localgovjp: Japanese local governments 日本の地方自治体一覧

Build time

Code for FUKUI (compiled from GSI and J-LIS municipality data)

Used for
Municipality names, official kana readings and town-hall coordinates for the city guides. English names are read from the kana (scripts/build-municipalities.ts) into src/data/municipalities.json.
License
CC0 1.0
Attribution
Municipality data: localgovjp by Code for FUKUI (CC0)
Last checked
  • CC0 needs no attribution; we credit it anyway.
  • A few readings that cross a word boundary (勝浦 is katsu + ura) are corrected by hand in the build script, and checked for every municipality with a catalog shop.

Soupmap Journal: further reading

Live

Wikipedia contributors

Used for
Each journal article links to English Wikipedia articles for further reading. The articles themselves are original writing; no Wikipedia text or images are copied.
License
Links only (Wikipedia text is CC BY-SA 4.0)
Attribution
Wikipedia contributors
Last checked
  • Links use Wikipedia's search with go=Go, which opens the article when the title exists and shows search results otherwise, so a renamed article never becomes a dead link.

Open-source libraries

Spark

Live

World Labs

Used for
Gaussian-splat “Step inside” viewer (loaded on demand).
License
MIT
Attribution
Spark by World Labs
Last checked

three.js

Live

three.js authors

Used for
Rendering for the splat viewer.
License
MIT
Attribution
three.js
Last checked

Supercluster

Live

Mapbox

Used for
Clustering shop pins at country and region zoom.
License
ISC
Attribution
Supercluster
Last checked

Zod

Build time

Colin McDonnell and contributors

Used for
Validating shops.json at build time.
License
MIT
Attribution
Zod
Last checked

Fonts

Services