License

Use the words freely.

The observation data michiyomi creates from street photos (text, structured data, changes over time) is available under CC BY 4.0. No credit or logo is needed in AI answers, analyses, app displays or quotes of individual records. Credit the source only when you redistribute it as data.

Conditions from 2026-10-03. The earlier CC BY-SA 4.0 grant remains valid, and you may use either (earlier conditions). This page summarizes the license field in API responses.

At a glance

UseWhat you need
Use in AI answers, analyses or reportsNothing
Show text or values in an app or mapNothing
Quote individual descriptions (including translations)Nothing
Redistribute observation data as dataWhen you provide it as files, databases, APIs for others or vector indexes containing the text, show the attribution and note any changes. Share-alike is not required.
Redistribute coordinates, capture times or image IDs in bulkmichiyomi does not license them. Check the conditions for that part yourself (layers). Per-record use is free.
Show a Mapillary photoCredit each photo's contributor (a link to the image page is enough) and CC BY-SA 4.0 (showing photos).
Build street lookup or descriptions into a public app or agentShow “© OpenStreetMap contributors” (streets and areas database).
Use 100+ streets or town blocks, or a whole municipalityShow “© OpenStreetMap contributors” and follow ODbL 1.0; redistribute that part as data under ODbL.

Please mention the capture year so readers do not mistake it for today's conditions. This is a request, not a condition.

Conditions by layer

Responses combine content from different sources. michiyomi sets the conditions for the observation data; everything else keeps its original conditions.

LayerContentConditions
Observation dataText (summary), structured data (analysis), machine features, changes, amenity descriptions, street and town-block aggregatesCC BY 4.0. No credit needed in results, displays or quotes; no share-alike
Mapillary reference dataCoordinates, compass angles, capture times, image IDs, sequence IDs. Most coordinates are positions Mapillary recomputed from the photos (position_source = mapillary_computed)Not licensed by michiyomi. Free to place on a map or cite per record. Check before bulk redistribution (EU/UK database rights; personal-data rules on contributors' locations and times)
PhotosMapillary street photos. Not included in responses; linked through image_pageEach contributor's CC BY-SA 4.0. Whoever fetches or embeds photos from Mapillary is bound by Mapillary's Terms of Use
Street skeletonStreet/edge names, road classes, shapes and lengths, and that information inside the karte texts© OpenStreetMap contributors, ODbL 1.0
Public-sector dataWards (MLIT National Land Numerical Information N03), schools (P29), town-block boundaries and population (e-Stat 2020 census)Credit the source and note processing when you distribute in bulk
Captured signs and personal dataSign text, shop names, trademarks; personal data and likenessesNot licensed. Using a shop name as a description is fine. Nameplate names and licence plates are masked
NameThe names and logo “みちよみ” and “michiyomi”Not covered by the license. You may name michiyomi as the source; please contact us before presenting anything as “official” or “provided by” michiyomi

Attribution texts

Not needed in results, displays or quotes. Use these when you redistribute as data, or whenever you want to credit the source.

Redistributing observation data

Source: michiyomi (michiyomi.dev), from Mapillary street-level photos, CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)

Streets and town blocks

The same as license.attribution_en in /v1/streets/…, /v1/areas/… and /v1/edges/… responses.

© OpenStreetMap contributors (https://www.openstreetmap.org/copyright) / michiyomi streets and areas database (ODbL 1.0) / observations: michiyomi (michiyomi.dev), CC BY 4.0

Distributing public-sector data in bulk

Town-block boundaries and population: processed from e-Stat “2020 Population Census, small-area statistics and boundaries” (Statistics Bureau of Japan) / Wards: processed from MLIT National Land Numerical Information (administrative areas) / Schools: based on MLIT National Land Numerical Information (schools), processed by michiyomi

Citing in a paper

michiyomi — Tokyo street-level verbalization open data (release 2026-09-13-r1)
https://michiyomi.dev/ (CC BY 4.0, from Mapillary street-level photos)

A caution note for apps and articles

Separate from attribution, this helps readers avoid misreading the data (same intent as license.caution_en).

Each description is an AI estimate from an image as of its capture year, not an assessment of current conditions or safety.

Showing photos

When you show a Mapillary photo itself, credit its contributor for each photo. A link to the image page (image_page in responses) is enough. Add the license (CC BY-SA 4.0) and note any changes such as cropping or resizing. Showing only text or values needs no logo or credit.

No logo or credit is needed to display text or values. Only when you show a Mapillary photo: credit its contributor (a link to the image page is enough), state CC BY-SA 4.0 and note any changes. Whoever fetches or embeds photos from Mapillary is bound by Mapillary's Terms of Use.
A side street in Shinjuku

Example credit:

Photo: a Mapillary contributor (image page), CC BY-SA 4.0, resized

Whoever fetches or embeds photos from Mapillary becomes a party to Mapillary's Terms of Use. If you serve photos from your own servers, show the Mapillary logo and link as the terms require. API responses do not include photos.

Streets and areas database

The streets, town-blocks and edges database (/v1/streets, /v1/areas, /v1/edges, MCP describe_street and others) is a derivative database of OpenStreetMap, provided under ODbL 1.0.

UseWhat you need
Look up a few and use them in an answerNothing
Build street lookup or descriptions into a public app or agent“© OpenStreetMap contributors” with a link to https://www.openstreetmap.org/copyright
Use 100+, or a whole municipalityThe credit above and an ODbL notice. If you combine or modify it with your data and use the result publicly, that database is also ODbL
Redistribute as dataODbL (share-alike, and an offer of the database)

Observation aggregates keyed by street_id or town_key are observation data under CC BY 4.0. On request, we provide a copy of the streets and areas database free of charge (contact@michiyomi.dev).

The license field in responses

REST responses include license. Its content depends on the product (scenes, streets and edges, town blocks, schools). Below is the value from GET /v1/meta.

"license": {
  "id": "LicenseRef-michiyomi-layered",
  "url": "https://michiyomi.dev/docs/license/",
  "obligations": {
    "use_in_results": ["none"],
    "display_or_quote_records": ["none"],
    "redistribute_as_data": ["attribution", "upstream_not_licensed_if_bulk", "source_notice_if_bulk"]
  },
  "layers": { "observation": "CC-BY-4.0", "mapillary_reference": "NOASSERTION", "public_sector": "CC-BY-4.0" },
  "linked_only": { "photo": "CC-BY-SA-4.0" },
  …
}

obligations tells you what to do in each situation (using in results / showing or quoting records / redistributing as data), with these values.

ValueMeaning
noneNo conditions
attributionWhen redistributing observation data as data, show the attribution text and note any changes
upstream_not_licensed_if_bulkWhen redistributing Mapillary reference data (coordinates, capture times, image IDs) in bulk, michiyomi grants no license for that part; check it yourself
source_notice_if_bulkWhen distributing public-sector data in bulk, credit the source and note processing
osm_attribution_if_public_appWhen building street lookup or descriptions into a public app or agent, show “© OpenStreetMap contributors”
odbl_notice_if_substantialWhen publicly using something made from a substantial part (100+, or a whole municipality) of the streets and areas database, credit OpenStreetMap and ODbL
odbl_share_alike_if_derivedWhen combining or modifying a substantial part with your data and using it publicly, the resulting database is also ODbL
odbl_if_substantialWhen redistributing a substantial part as data, follow ODbL

notices lists the kinds of caution: mapillary_reference_not_licensed, photos_not_included, third_party_signs_and_marks, personal_data_not_licensed, ai_generated (AI estimates as of the capture year), adaptation_clause (section 8 of the declaration).

MCP tool results include license (a string), license_url, attribution, obligations and license_note.

Hugging Face dataset

For analysis of all records, use finalvent/michiyomi-tokyo-streetscape (Parquet).

License
Observation data under CC BY 4.0 (v0.1–v0.3.1 are covered by the declaration on this page). Reference values and public-sector data follow the conditions by layer
Version
v0.3.1 (release 2026-09-13-r1, with nameplate names and licence plates masked; it may be updated at a different time from the API)
Contents
scenes (Parquet per municipality, 1,914,490 rows), changes (2,522 rows), schools (1,323 rows), generations
Not included
The photos themselves. Each row's id leads to the original photo.

License of the OddEye model

OddEye 0.1 27B, the model built to read street photos, is under Apache-2.0 (the same as its base model, Qwen3.8-27B). We place no conditions on its outputs. The public data on this site was not made with OddEye; its conditions are as above. See OddEye.

Additional Permission and Clarification (3 October 2026)

The formal statement of the change. The Japanese version is here.

The operator of michiyomi (the “Operator”) declares the following regarding the data published by michiyomi (https://michiyomi.dev).

1. Scope

This declaration covers the following data (the “Covered Data”):

  • (a) All revisions of v0.1, v0.2, v0.3 and v0.3.1 of the Hugging Face dataset finalvent/michiyomi-tokyo-streetscape.
  • (b) Responses of the michiyomi.dev REST API, MCP server and scenery search (/explore/) based on the releases published by 3 October 2026 (2026-08-21-r1, 2026-08-22-r1, 2026-08-26-r1, 2026-08-28-r1, 2026-09-13-r1, 2026-09-22-la1, 2026-10-03-la2).
  • (c) Data files obtainable from michiyomi.dev pages that are based on the same releases as (b).
  • (d) Releases listed, with a date, as covered by this declaration under “Covered releases” on this page.

Data provided under authentication and individual contracts (paid provision, commissioned work, pre-release versions) is not covered.

2. Earlier grant

The grant made when the Covered Data was published under CC BY-SA 4.0 is not revoked and remains valid. Users may rely on either the earlier conditions or the conditions of this declaration. The parts derived from OpenStreetMap under section 7 have always been subject to ODbL 1.0.

3. Additional permission

For the observation layer of the Covered Data (Annex 1), the Operator also grants use under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/legalcode), to the extent of the rights it holds.

In addition, whether under CC BY 4.0 or CC BY-SA 4.0, the Operator does not require any credit to michiyomi for the following uses:

  • (a) Results: answers, analyses, charts, app displays, trained models, embeddings (vectors) that do not contain the original text, and similar outputs obtained by using the Covered Data for search, computation, summarization, inference, visualization, machine learning or similar purposes, whose main purpose is not to extract and reuse records of the Covered Data.
  • (b) Individual display and quotation: presenting individual records or summaries in human-readable form (including in translation).

Share-alike and display of any logo are not required for any use.

4. Redistribution as data

If you provide records of the observation layer in a form that third parties can extract and reuse (files, databases, APIs offered to third parties, map tiles keeping per-record attributes, vector indexes containing the text, etc.), the condition of section 3(a) of CC BY 4.0 applies. Showing “Source: michiyomi (michiyomi.dev), CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)” and indicating any modification satisfies the section 3(a) conditions of both CC BY 4.0 and CC BY-SA 4.0. Items of section 3(a)(1)(A) of either license not contained in this format are not required.

The following is not redistribution under this section:

  • Use solely within an organization.
  • Sending data from your own servers to users' devices to display it in your own app or site (except where offered or provided as a download or API for third parties).
  • Passing responses between programs or AI agents for processing. In this case, it is sufficient to pass on the response's license as is.

5. Clarification of earlier statements

Among earlier statements, the following are not conditions required on the basis of michiyomi's rights:

  • (a) Statements that a screen displaying the data requires the Mapillary logo and link (e.g. “Any UI displaying this data must show a visible Mapillary logo linked to https://www.mapillary.com”).
  • (b) Statements that CC BY-SA 4.0 is inherited by derived works or derived data (e.g. “share-alike applies to derived works”, “Data you derive from it inherits CC BY-SA 4.0”).
  • (c) Statements that attribution is required for any use, including in AI answers (e.g. “Show attribution whenever you use it, including in an AI-generated answer”).

Conditions for displaying or serving Mapillary photos are governed by each contributor's CC BY-SA 4.0 and by Mapillary's Terms of Use, which apply to whoever fetches or serves photos from Mapillary.

6. What this declaration does not cover

This declaration is limited to the rights held by the Operator. It does not extend to, and the Operator does not license, the following:

  • (a) Mapillary photos (not part of the Covered Data).
  • (b) Values computed by Mapillary and values converted from them (Annex 2).
  • (c) Values based on Mapillary map-feature data (such as segment_priority_score).
  • (d) Reference information supplied by contributors (raw GPS coordinates, compass angles, capture times, image IDs, sequence IDs, etc.). This does not prevent using them as facts record by record.
  • (e) Rights of OpenStreetMap.
  • (f) Data of national or local governments (areas, schools, town-block boundaries and population, etc.).
  • (g) Third-party text, trademarks and signs captured in photos.
  • (h) Personal data and likenesses. CC BY 4.0 does not permit the use of personal data. If you find a description that identifies an individual, please tell us at contact@michiyomi.dev.
  • (i) The names and logo “みちよみ” and “michiyomi”.

7. Streets and areas database

The streets, town-blocks and edges database is a derivative database of OpenStreetMap, provided under ODbL 1.0 (https://opendatacommons.org/licenses/odbl/1-0/). The same applies to OpenStreetMap-derived parts of earlier responses. Columns derived from OpenStreetMap (names, road classes, shapes, lengths, etc.) and OpenStreetMap information contained in karte texts are subject to ODbL. michiyomi's independent data linked by keys, such as aggregates, is governed by sections 2 to 4; however, extracting a substantial part of the database triggers ODbL. On request, the Operator provides a copy of this database free of charge (ODbL section 4.6).

8. Where it is an adaptation

To the extent that, under the law applicable to a use, part of the observation layer is an adaptation of a photo (Adapted Material under CC BY-SA 4.0), the Operator licenses its contribution to that part under CC BY-SA 4.0 as the adapter's license and waives that license's conditions to the same extent as sections 3 and 4. Conditions based on the photographer's rights remain for that part.

9. No revocation

The Operator will not revoke the permissions and waivers in this declaration, and will not add conditions beyond this declaration for the Covered Data. Conditions for new releases not covered here will be shown on this page for each release.

10. Languages

This declaration is given in Japanese and English. If they differ, the version with fewer conditions for the user applies.

Annex (as of 3 October 2026)

1. Observation layer (words michiyomi created from photos with AI, and values michiyomi computed)

  • Scenes: summary, analysis (all keys including townscape.poi_signs; descriptions that are personal data are excluded under section 6(h); responses from 3 October 2026 and v0.3.1 mask nameplate names and licence plates), provenance fields model, prompt_version, generation, generated_at, content_sha256, analysis_status, and quarantined
  • Machine layer: feature_version, month, weekday, hour, season, time_bucket, left_side8, right_side8, abs_objects (compass conversion uses Mapillary's computed_compass), colorfulness, green_ratio, warm_ratio, dominant_colors, color_status, travel_bearing, view_class
  • Changes: change_id, group_id, category, year_a, year_b, subject, evidence, status, verification
  • Amenities: evidence, object_position, object_distance_m_est, confidence
  • Independent street and town-block data: profile.stats, l2_segments, distinct_terms, and the Operator's contribution to karte texts (excluding OpenStreetMap information; section 7)
  • Tags and quotations in scenery search

2. Mapillary reference layer (not licensed by the Operator)

  • Values supplied by contributors: id, image_page, sequence_id, captured_at_ms, captured_at_jst, capture_year, capture_time_quality, raw_lat, raw_lon, raw_compass, camera_type, is_pano, width, height, and scene_ids_a, scene_ids_b of changes
  • Values computed by Mapillary and their conversions: lat, lon (where position_source is mapillary_computed), position_source, position_offset_m, computed_lat, computed_lon, computed_compass, heading, heading8, cell_250m, and lat, lon of changes and amenities
  • Values derived from Mapillary data: quality_score, segment_priority_score

3. Public-sector data

ward (National Land Numerical Information N03), the school table (P29), and town-block town_key, names, boundaries, population, households and area (e-Stat 2020 census)

4. Derived from OpenStreetMap

As in section 7.

Covered releases

Listed onReleasesHugging Face
2026-10-032026-08-21-r1, 2026-08-22-r1, 2026-08-26-r1, 2026-08-28-r1, 2026-09-13-r1, 2026-09-22-la1, 2026-10-03-la2v0.1, v0.2, v0.3, v0.3.1
2026-10-04— (PLATEAU companion dataset; verbalizations from 2026-09-13-r1)finalvent/michiyomi-tokyo-plateau v0.1 (PLATEAU-derived parts such as feature IDs and representative points follow the PLATEAU Site Policy)

Earlier conditions

Until 3 October 2026, this site stated “data under CC BY-SA 4.0”, “derived data inherits it”, “screens displaying the data need the Mapillary logo” and “credit the source in AI answers”. The CC BY-SA 4.0 grant is not revoked and remains valid. As section 5 of the declaration states, the logo, share-alike and credit in AI answers are not conditions required on the basis of michiyomi's rights.

Questions and removal requests

Contact us at contact@michiyomi.dev. Requests to remove people, nameplates, licence plates and similar content captured in photos are accepted at the same address. You can also ask Mapillary to remove the original photo.