← Home

Data sources

This page explains where the data on this site comes from, and its licences and attribution. If you find an error, please let us know through the contact form.

OpenStreetMap (locations and names of candidate onsen)

Most onsen without a registered analysis report (“candidate onsen”) are based on locations (latitude and longitude) and names imported from OpenStreetMap. They appear as map pins, in lists and on facility pages.

We run the import manually, so changes made in OpenStreetMap are not reflected automatically. After importing, we may correct names or English names using sources such as official websites, and add analysis reports and booking-site information.

Our facility database combines OpenStreetMap data with our own information (such as analysis reports and booking-site details), and we treat it as a Derivative Database under the ODbL. If you would like the OpenStreetMap-derived part, please use the contact form.

What we use from OpenStreetMap:

  • Locations and names of natural=hot_spring (hot springs), amenity=public_bath (public baths) and tourism=hotel features whose name contains “温泉” (onsen), retrieved with the Overpass API
  • Name tags in other languages, such as name:en, name:zh-Hant, name:zh-Hans and name:ko (used for facility names on our translated pages)
  • Tags such as tourism, amenity and natural (used to classify facilities as inns, day-use baths, springs and so on)
  • Draft English addresses when a new facility is registered (Nominatim, an address search based on OpenStreetMap data)

OpenStreetMap attribution and licence

© OpenStreetMap contributors

OpenStreetMap is open data, licensed under the Open Data Commons Open Database License (ODbL) by the OpenStreetMap Foundation. The copyright and licence terms are on the page linked above.

Open Database License (ODbL) 1.0

Maps (Mapbox)

Our maps and place search use Mapbox. The base map is made by Mapbox from OpenStreetMap and other data; the Mapbox and OpenStreetMap attribution is shown in the corner of each map (it folds into the (i) button once you move the map).

When a facility is not in OpenStreetMap, we may take its location from Rakuten Travel, Google place search or Mapbox geocoding.

Spring types and minerals (onsen analysis reports)

Spring types, pH and mineral values come from onsen analysis reports. Under Article 18 of Japan’s Hot Springs Act, facilities that use hot spring water must post this report.

We collect reports from user uploads, official facility websites and documents published by local governments (such as Oita Prefecture), and read them with OCR and AI before registering them. Uploaded report images are not published.

Reports are generally renewed about every 10 years, so the one shown may not be the latest.

Spring type names and indications in other languages (Ministry of the Environment)

English, Chinese (Traditional and Simplified) and Korean names of spring types, indications and contraindications, and their explanations follow the translations in the Ministry of the Environment’s manual for multilingual support at hot spring resorts (2021, in Japanese with translations).

Each guide article lists its sources at the end.

Inn prices and photos (booking sites)

Some inn names, lowest prices, review scores and photos are retrieved from the Rakuten Travel API (Rakuten Web Service). Prices are as of when we last retrieved them; please check the actual price and availability on the booking site.

Some inn photos are the ones listed on Agoda, Rakuten Travel and Ikyu.

Booking buttons link to the inn’s page on booking sites such as Rakuten Travel, Jalan, Ikyu, Agoda, Trip.com and Booking.com. They include affiliate (commission-based advertising) links.

Other

  • Official facility information (day-use bathing, private baths and so on) is researched by AI from official websites and other sources, with a source link for each item.
  • Some facility descriptions, translations and guide articles are written with generative AI. Most illustrations in the guides are also AI-generated images.

Reporting errors

If you find an error in a location, name or mineral value, please let us know through the contact form. Anyone can fix OpenStreetMap data on OpenStreetMap (changes there are not reflected on this site automatically).