{"api_version":"v1","name":"michiyomi API","description":"Read-only API for structured VLM descriptions of Mapillary street-level imagery, searchable by coordinates. No authentication is required. Returned streetscape narratives are in Japanese.","description_ja":"Mapillary街路画像をVLMで構造化テキスト化した『座標×言語化』の配信API。同一地点に複数の言語化世代が共存し、既定ではreleased世代のみを返す。","data_language":"ja","endpoints":{"GET /v1/meta":"Authoritative release counts and verbalization-generation catalog","GET /v1/scenes/nearby":"Nearby scenes. Requires lat/lon; supports radius_m, limit, quality, generation, and capture-year filters","GET /v1/amenities/nearby":"Nearby amenity observations (kind=vending_machine|toilet|bench), with capture-year and source evidence. Coordinates identify image capture locations, not surveyed equipment positions","POST /amenities/search":"Same amenity search with coordinates in a JSON body (keeps visitor locations out of URLs); /vending/search is an alias","GET /v1/scenes/{id}":"Scene detail. Select metadata, deterministic machine features, and/or Japanese VLM analysis with include=","GET /v1/coverage":"Honest coverage report around a coordinate; zero means no recorded data, not no real-world features","GET /v1/changes/nearby":"Nearby adjudicated longitudinal change observations with category/status filters","GET /v1/changes/{change_id}":"Full change evidence and verification metadata","GET /v1/schools/search":"Partial-name search for elementary schools (NFKC normalized; up to 10 results)","GET /v1/generations":"Verbalization-generation catalog and governance metadata","GET /v1/provenance":"Release manifest and gen1 provenance chain","POST /mcp":"Stateless MCP Streamable HTTP endpoint (2025-06-18 compatible; no SSE)"},"aliases":{"GET /v1/nearby":"GET /v1/scenes/nearby","GET /v1/node/{id}":"GET /v1/scenes/{id}","GET /v1/prov":"GET /v1/provenance"},"policies":["The default is quality=released. Experimental generations are returned only when explicitly requested.","Scenes with anomalous capture timestamps (quarantined=1) are excluded from nearby search and coverage statistics and are available only by direct ID lookup.","A zero-result response means no data was recorded for that area and policy; it does not prove that no real-world feature or change exists.","Longitudinal change candidates undergo counterexample-first rechecking in a context-separated session of the same model family. Shared systematic errors may remain."],"policies_ja":["既定は quality=released。experimental世代は quality=include_experimental / experimental_only / generation= の明示指定でのみ返る。","撮影時刻が異常なシーン(quarantined=1)は近傍検索・統計から除外され、IDの直接参照でのみ取得できる。","0件は0件として返す。『変化が無かった』という断定はしない(収録が無いだけ)。","経年変化の裁定は同一モデル系列の文脈分離した別セッションによる反証優先の再検証。検証者と検出者は同じモデル系列であり、共有された系統誤差は残りうる。"],"request_id":"e6c79973-9ab3-4613-aa3e-6c69b9e4367c","license":{"schema_version":2,"id":"LicenseRef-michiyomi-layered","url":"https://michiyomi.dev/docs/license/","policy_version":"2026-10-03","summary":"観測データ(本文・構造化JSON・機械層の値・経年変化)は CC BY 4.0 で使えます。AIの回答・分析・アプリの表示・個別の転記には、出典もロゴも要りません。データとして配り直すとき(ファイル・データベース・第三者向けの API など)は attribution を表示してください。座標・撮影日時・画像IDは Mapillary 由来の参照情報で、1件ずつ使うのは自由ですが、みちよみは許諾しません(まとめて配るときは各自で確認)。写真はこの応答に含まれません。写り込んだ看板の文言・商標と個人情報は許諾の対象外です。","summary_en":"Observation data (text, structured JSON, machine features, changes) is available under CC BY 4.0. No credit or logo is needed in AI answers, analyses, app displays or quotes of individual records. When you redistribute records as data (files, databases, APIs for others), show the attribution. Coordinates, capture times and image IDs are Mapillary reference data: free to use per record, but michiyomi does not license them for bulk redistribution. Photos are not included. Sign text, trademarks and personal data are not licensed.","obligations":{"use_in_results":["none"],"display_or_quote_records":["none"],"redistribute_as_data":["attribution","upstream_not_licensed_if_bulk","source_notice_if_bulk"]},"notices":["mapillary_reference_not_licensed","photos_not_included","third_party_signs_and_marks","personal_data_not_licensed","ai_generated","adaptation_clause"],"layers":{"observation":"CC-BY-4.0","mapillary_reference":"NOASSERTION","public_sector":"CC-BY-4.0"},"linked_only":{"photo":"CC-BY-SA-4.0"},"attribution":"出典: みちよみ(michiyomi.dev、Mapillary の街路写真より)、CC BY 4.0(https://creativecommons.org/licenses/by/4.0/)","attribution_en":"Source: michiyomi (michiyomi.dev), from Mapillary street-level photos, CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)","public_sector_sources":["「国土数値情報(行政区域データ)」(国土交通省)を加工して作成"],"mapillary":"https://www.mapillary.com","ui_requirements":"テキストや数値を表示するだけなら、ロゴも出典も要りません。Mapillary の写真を表示する場合だけ、撮影者(画像ページへのリンクで可)と CC BY-SA 4.0 を示し、加工したならその旨を添えてください。写真を Mapillary から取得・埋め込む人は、Mapillary の利用規約に従います。","ui_requirements_en":"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.","caution":"AI が単眼の写真から推定した記述で、撮影年時点のものです。安全・通行・バリアフリーの判断は現地で確かめてください。","caution_en":"AI estimates from a single photo, as of the capture year. Verify on site before safety, access or accessibility decisions.","previous_id":"CC-BY-SA-4.0","license_changed_at":"2026-10-03"}}