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.
At a glance
| Use | What you need |
|---|---|
| Use in AI answers, analyses or reports | Nothing |
| Show text or values in an app or map | Nothing |
| Quote individual descriptions (including translations) | Nothing |
| Redistribute observation data as data | When 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 bulk | michiyomi does not license them. Check the conditions for that part yourself (layers). Per-record use is free. |
| Show a Mapillary photo | Credit 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 agent | Show “© OpenStreetMap contributors” (streets and areas database). |
| Use 100+ streets or town blocks, or a whole municipality | Show “© 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.
| Layer | Content | Conditions |
|---|---|---|
| Observation data | Text (summary), structured data (analysis), machine features, changes, amenity descriptions, street and town-block aggregates | CC BY 4.0. No credit needed in results, displays or quotes; no share-alike |
| Mapillary reference data | Coordinates, 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) |
| Photos | Mapillary street photos. Not included in responses; linked through image_page | Each contributor's CC BY-SA 4.0. Whoever fetches or embeds photos from Mapillary is bound by Mapillary's Terms of Use |
| Street skeleton | Street/edge names, road classes, shapes and lengths, and that information inside the karte texts | © OpenStreetMap contributors, ODbL 1.0 |
| Public-sector data | Wards (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 data | Sign text, shop names, trademarks; personal data and likenesses | Not licensed. Using a shop name as a description is fine. Nameplate names and licence plates are masked |
| Name | The 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
Streets and town blocks
The same as license.attribution_en in /v1/streets/…, /v1/areas/… and /v1/edges/… responses.
Distributing public-sector data in bulk
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).
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.
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.
| Use | What you need |
|---|---|
| Look up a few and use them in an answer | Nothing |
| 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 municipality | The 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 data | ODbL (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.
| Value | Meaning |
|---|---|
none | No conditions |
attribution | When redistributing observation data as data, show the attribution text and note any changes |
upstream_not_licensed_if_bulk | When redistributing Mapillary reference data (coordinates, capture times, image IDs) in bulk, michiyomi grants no license for that part; check it yourself |
source_notice_if_bulk | When distributing public-sector data in bulk, credit the source and note processing |
osm_attribution_if_public_app | When building street lookup or descriptions into a public app or agent, show “© OpenStreetMap contributors” |
odbl_notice_if_substantial | When 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_derived | When combining or modifying a substantial part with your data and using it publicly, the resulting database is also ODbL |
odbl_if_substantial | When 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
idleads 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
licenseas 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 includingtownscape.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 fieldsmodel,prompt_version,generation,generated_at,content_sha256,analysis_status, andquarantined - Machine layer:
feature_version,month,weekday,hour,season,time_bucket,left_side8,right_side8,abs_objects(compass conversion uses Mapillary'scomputed_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, andscene_ids_a,scene_ids_bof changes - Values computed by Mapillary and their conversions:
lat,lon(whereposition_sourceismapillary_computed),position_source,position_offset_m,computed_lat,computed_lon,computed_compass,heading,heading8,cell_250m, andlat,lonof 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 on | Releases | Hugging Face |
|---|---|---|
| 2026-10-03 | 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 | v0.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.