Commlo commute network
Dated drive and Metra train commute facts for Chicago-area addresses and stations.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"commute-network": {
"url": "https://public.commlo.com/mcp"
}
}
}リモートエンドポイント
https://public.commlo.com/mcpstreamable-httpできること
ツール一覧
ツール(3)
🟢commute_lookup(address_id, address_text, components, service_date, direction, ...)
Commute from one Chicago-area residential address to downtown Chicago on one service date: drive to a Metra station (without traffic), station buffer and scheduled train, for up to 5 station options (nearest stations first), with sources and a methodology link.
入力スキーマ
{
"type": "object",
"properties": {
"address_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"address_text": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"components": {
"type": "object",
"additionalProperties": false,
"required": [
"house_number",
"street_predirectional",
"street_name",
"street_suffix",
"street_postdirectional",
"building_designator",
"building_value",
"unit_designator",
"unit_value",
"floor",
"postal_city",
"state",
"postal_code"
],
"properties": {
"house_number": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"street_predirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"street_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"street_suffix": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"street_postdirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"building_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"building_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"unit_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"unit_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"postal_city": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
},
"state": {
"type": "string",
"enum": [
"AK",
"AL",
"AR",
"AS",
"AZ",
"CA",
"CO",
"CT",
"DC",
"DE",
"FL",
"GA",
"GU",
"HI",
"IA",
"ID",
"IL",
"IN",
"KS",
"KY",
"LA",
"MA",
"MD",
"ME",
"MI",
"MN",
"MO",
"MP",
"MS",
"MT",
"NC",
"ND",
"NE",
"NH",
"NJ",
"NM",
"NV",
"NY",
"OH",
"OK",
"OR",
"PA",
"PR",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VA",
"VI",
"VT",
"WA",
"WI",
"WV",
"WY"
]
},
"postal_code": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5}(?:-\\d{4})?$"
},
{
"type": "null"
}
]
}
}
},
"service_date": {
"type": "string",
"format": "date"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound"
]
},
"terminal_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"window_id": {
"type": "string",
"enum": [
"inbound_am",
"outbound_pm",
"inbound_offpeak",
"outbound_offpeak",
"weekend_daytime",
"early_late"
]
},
"arrive_by": {
"type": "string",
"minLength": 4,
"description": "A clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset, for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z."
},
"depart_after": {
"type": "string",
"minLength": 4,
"description": "A clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset, for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z."
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800,
"default": 300
},
"options": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"default": 3,
"description": "How many options to return, from 1 to 5, default 3. The nearest one or two stations are always included, so an answer can hold more options than requested."
},
"context": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"intent": {
"type": "string",
"enum": [
"buy",
"rent"
],
"description": "buy or rent, only if the user said so. Tailors the answer."
},
"budget_usd": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"min": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
"max": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
}
},
"minProperties": 1,
"description": "Budget range in whole US dollars, only if the user stated one. Does not change the answer yet."
},
"timeline": {
"type": "string",
"enum": [
"now",
"1_3_months",
"3_6_months",
"6_12_months",
"over_12_months"
],
"description": "How soon the user plans to move, only if stated. Does not change the answer."
},
"wants_agent_contact": {
"type": "boolean",
"description": "True only if the user asked to be connected with a listing agent. Returns the agent's contact when listing contact is enabled."
}
},
"minProperties": 1,
"description": "Optional. Fill only with facts the user volunteered. No names, contact details or chat text."
}
},
"required": [
"service_date"
],
"additionalProperties": false,
"description": "One address selector. Exactly one of window_id, arrive_by, or depart_after. arrive_by and depart_after accept a clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset (for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z). An omitted direction follows the window (outbound_pm and outbound_offpeak are outbound; other windows and requested times stay inbound). An outbound requested time searches every downtown terminal unless terminal_id is set."
}出力スキーマ
{
"type": "object",
"$defs": {
"PublicAddress": {
"type": "object",
"additionalProperties": false,
"required": [
"address_id",
"site_id",
"kind",
"display_address",
"components",
"location_quality",
"indexable"
],
"properties": {
"address_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"site_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"building_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"kind": {
"type": "string",
"enum": [
"site",
"unit"
]
},
"display_address": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"components": {
"type": "object",
"additionalProperties": false,
"required": [
"house_number",
"street_predirectional",
"street_name",
"street_suffix",
"street_postdirectional",
"building_designator",
"building_value",
"unit_designator",
"unit_value",
"floor",
"postal_city",
"state",
"postal_code"
],
"properties": {
"house_number": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"street_predirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"street_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"street_suffix": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"street_postdirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"building_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"building_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"unit_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"unit_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"postal_city": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
},
"state": {
"type": "string",
"enum": [
"IL",
"WI"
]
},
"postal_code": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5}(?:-\\d{4})?$"
},
{
"type": "null"
}
]
}
}
},
"municipality_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"location_quality": {
"type": "string",
"enum": [
"exact",
"interpolated",
"approximate",
"alias",
"candidate",
"review"
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"indexable": {
"type": "boolean"
},
"unit_caveat": {
"type": "string",
"enum": [
"unverified_unit"
]
}
}
},
"PublicCommuteOption": {
"type": "object",
"additionalProperties": false,
"required": [
"station_id",
"station_name",
"route_id",
"route_name",
"terminal_id",
"terminal_name",
"trip_id",
"departure_at",
"departure_local",
"arrival_at",
"arrival_local",
"departure_s",
"arrival_s",
"drive_ms",
"drive_seconds",
"train_seconds",
"buffer_seconds",
"total_ms",
"total_seconds",
"total_minutes",
"express_class",
"group",
"traffic",
"other_arrivals",
"quality",
"limitations"
],
"properties": {
"station_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"station_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"station_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"route_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"route_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"terminal_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"terminal_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"terminal_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"trip_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"departure_at": {
"type": "string",
"format": "date-time"
},
"departure_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"arrival_at": {
"type": "string",
"format": "date-time"
},
"arrival_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"departure_s": {
"type": "integer",
"minimum": 0
},
"arrival_s": {
"type": "integer",
"minimum": 0
},
"drive_ms": {
"type": "integer",
"minimum": 0,
"maximum": 2700000
},
"drive_seconds": {
"type": "number",
"minimum": 0
},
"train_seconds": {
"type": "integer",
"minimum": 0
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800
},
"total_ms": {
"type": "integer",
"minimum": 0
},
"total_seconds": {
"type": "number",
"minimum": 0
},
"total_minutes": {
"type": "integer",
"minimum": 0
},
"express_class": {
"type": "string",
"enum": [
"local",
"limited",
"unknown"
]
},
"group": {
"type": "string",
"enum": [
"nearest",
"other"
]
},
"traffic": {
"const": "none"
},
"other_arrivals": {
"type": "array",
"maxItems": 80,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"trip_id",
"arrival_s",
"arrival_at",
"arrival_local"
],
"properties": {
"trip_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"arrival_s": {
"type": "integer",
"minimum": 0
},
"arrival_at": {
"type": "string",
"format": "date-time"
},
"arrival_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
}
}
}
},
"other_arrivals_text": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"quality": {
"type": "string",
"enum": [
"usable",
"approximate",
"review_required",
"invalid"
]
},
"limitations": {
"type": "array",
"maxItems": 5,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"approximate_origin",
"non_exact_timepoint",
"downtown_intermediate",
"train_over_24h",
"contact_unavailable"
]
}
},
"home_leave_at": {
"type": "string",
"format": "date-time"
},
"home_leave_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"home_arrive_at": {
"type": "string",
"format": "date-time"
},
"home_arrive_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"arrival_slack_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 86400
}
}
},
"PublicCommuteResult": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"address",
"versions",
"service_date",
"timezone",
"direction",
"buffer_seconds",
"status",
"options",
"service_notices",
"listing",
"methodology_url",
"warnings",
"source_credits"
],
"properties": {
"schema_version": {
"const": 1
},
"address": {
"$ref": "#/$defs/PublicAddress"
},
"versions": {
"$ref": "#/$defs/PublicVersions"
},
"service_date": {
"type": "string",
"format": "date"
},
"timezone": {
"const": "America/Chicago"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound"
]
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800
},
"status": {
"type": "string",
"enum": [
"ready",
"no_eligible_road_leg",
"no_service_in_window",
"summary_refreshing"
]
},
"options": {
"type": "array",
"maxItems": 5,
"items": {
"$ref": "#/$defs/PublicCommuteOption"
}
},
"service_notices": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"station_id",
"station_name",
"route_id",
"group",
"code",
"text"
],
"properties": {
"station_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"station_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"route_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"group": {
"const": "nearest"
},
"code": {
"type": "string",
"enum": [
"no_saturday_service",
"no_sunday_service"
]
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
},
"listing": {
"$ref": "#/$defs/PublicListing"
},
"methodology_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"warnings": {
"type": "array",
"maxItems": 4,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"non_exact_timepoint",
"approximate_origin",
"contact_unavailable",
"train_horizon"
]
}
},
"source_credits": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"source_slug",
"attribution"
],
"properties": {
"source_slug": {
"type": "string",
"pattern": "^[a-z][a-z0-9-]{0,63}$"
},
"attribution": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
}
}
},
"PublicErrorEnvelope": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"error"
],
"properties": {
"schema_version": {
"const": 1
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"retryable",
"request_id"
],
"properties": {
"code": {
"type": "string",
"enum": [
"PUBLIC_ADDRESS_AMBIGUOUS",
"PUBLIC_CAPACITY_UNAVAILABLE",
"PUBLIC_CONTACT_UNAVAILABLE",
"PUBLIC_CURSOR_EXPIRED",
"PUBLIC_CURSOR_INVALID",
"PUBLIC_DATA_UNAVAILABLE",
"PUBLIC_INVALID_ARGUMENT",
"PUBLIC_NOT_FOUND",
"PUBLIC_NO_SERVICE",
"PUBLIC_OUT_OF_COVERAGE",
"PUBLIC_PLACE_AMBIGUOUS",
"PUBLIC_RATE_LIMITED",
"PUBLIC_SCHEDULE_UNAVAILABLE",
"PUBLIC_SEARCH_TOO_BROAD",
"PUBLIC_STATION_AMBIGUOUS",
"PUBLIC_STATION_NOT_FOUND",
"PUBLIC_VERSION_UNSUPPORTED"
]
},
"message": {
"type": "string",
"enum": [
"More than one address matches.",
"Capacity is unavailable.",
"Listing contact is unavailable.",
"The page cursor has expired.",
"The page cursor is not valid.",
"Public data is unavailable.",
"The request is not valid.",
"No public record is available.",
"No service is available for that request.",
"That address is outside Commlo coverage.",
"More than one place matches.",
"The request rate is limited.",
"Schedule data is unavailable.",
"The search is too broad.",
"More than one station matches.",
"No Metra station matches that name or ID exactly. Any close matches are listed.",
"This contract version is not supported."
]
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"valid_from": {
"type": "string",
"format": "date"
},
"valid_through": {
"type": "string",
"format": "date"
},
"detail": {
"type": "object",
"additionalProperties": false,
"required": [
"field",
"reason",
"expected"
],
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"expected": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
}
},
"candidates": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"kind",
"id",
"display"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"address",
"station",
"place"
]
},
"id": {
"type": "string"
},
"display": {
"type": "string",
"maxLength": 200
}
}
}
}
}
},
"PublicListing": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"address_id",
"status",
"source",
"effective_at",
"observed_at",
"valid_until",
"representation",
"contact",
"co_listing_contacts",
"attribution",
"projection_version"
],
"properties": {
"schema_version": {
"const": 1
},
"address_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"status": {
"type": "string",
"enum": [
"active",
"pending",
"sold",
"off_market",
"unknown"
]
},
"source": {
"anyOf": [
{
"type": "string",
"enum": [
"agent_reported",
"idx_own_listing",
"mls_grid",
"idx_observed"
]
},
{
"type": "null"
}
]
},
"effective_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"effective_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"observed_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"valid_until": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"valid_until_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"representation": {
"type": "string",
"enum": [
"current",
"none"
]
},
"contact": {
"anyOf": [
{
"$ref": "#/$defs/PublicListingContact"
},
{
"type": "null"
}
]
},
"co_listing_contacts": {
"type": "array",
"maxItems": 4,
"items": {
"$ref": "#/$defs/PublicListingContact"
}
},
"attribution": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"projection_version": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,18})$"
}
}
},
"PublicListingContact": {
"type": "object",
"additionalProperties": false,
"required": [
"directory_contact_id",
"display_name",
"brokerage_name",
"verification",
"verified_at",
"verified_local",
"business_phone",
"business_website",
"disclosure"
],
"properties": {
"directory_contact_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"display_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"brokerage_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"verification": {
"type": "string",
"enum": [
"identity_verified",
"provider_attributed"
]
},
"verified_at": {
"type": "string",
"format": "date-time"
},
"verified_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"business_phone": {
"anyOf": [
{
"type": "string",
"minLength": 7,
"maxLength": 32
},
{
"type": "null"
}
]
},
"business_website": {
"anyOf": [
{
"type": "string",
"format": "uri",
"pattern": "^https://"
},
{
"type": "null"
}
]
},
"disclosure": {
"const": "represents_seller"
}
}
},
"PublicVersions": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"catalog_version",
"corpus_version",
"road_version",
"graph_version",
"train_version",
"methodology_version",
"station_access_version",
"computed_at",
"computed_local",
"published_at",
"published_local",
"train_valid_from",
"train_valid_through"
],
"properties": {
"schema_version": {
"const": 1
},
"catalog_version": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"corpus_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"road_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"graph_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"train_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"methodology_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"station_access_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"computed_at": {
"type": "string",
"format": "date-time"
},
"computed_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"train_valid_from": {
"type": "string",
"format": "date"
},
"train_valid_through": {
"type": "string",
"format": "date"
}
}
}
},
"oneOf": [
{
"$ref": "#/$defs/PublicCommuteResult"
},
{
"$ref": "#/$defs/PublicErrorEnvelope"
}
]
}🟢commute_lookup_batch(service_date, direction, terminal_id, window_id, arrive_by, ...)
The same dated commute as commute_lookup for up to 10 Chicago-area addresses in one call, for comparing homes. Returns one result per address in request order; an address that cannot be answered gets its own error entry and the others still answer. Default 1 option per address.
入力スキーマ
{
"type": "object",
"properties": {
"service_date": {
"type": "string",
"format": "date"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound"
]
},
"terminal_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"window_id": {
"type": "string",
"enum": [
"inbound_am",
"outbound_pm",
"inbound_offpeak",
"outbound_offpeak",
"weekend_daytime",
"early_late"
]
},
"arrive_by": {
"type": "string",
"minLength": 4,
"description": "A clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset, for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z."
},
"depart_after": {
"type": "string",
"minLength": 4,
"description": "A clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset, for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z."
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800,
"default": 300
},
"addresses": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"address_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"address_text": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"components": {
"type": "object",
"additionalProperties": false,
"required": [
"house_number",
"street_predirectional",
"street_name",
"street_suffix",
"street_postdirectional",
"building_designator",
"building_value",
"unit_designator",
"unit_value",
"floor",
"postal_city",
"state",
"postal_code"
],
"properties": {
"house_number": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"street_predirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"street_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"street_suffix": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"street_postdirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"building_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"building_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"unit_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"unit_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"postal_city": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
},
"state": {
"type": "string",
"enum": [
"AK",
"AL",
"AR",
"AS",
"AZ",
"CA",
"CO",
"CT",
"DC",
"DE",
"FL",
"GA",
"GU",
"HI",
"IA",
"ID",
"IL",
"IN",
"KS",
"KY",
"LA",
"MA",
"MD",
"ME",
"MI",
"MN",
"MO",
"MP",
"MS",
"MT",
"NC",
"ND",
"NE",
"NH",
"NJ",
"NM",
"NV",
"NY",
"OH",
"OK",
"OR",
"PA",
"PR",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VA",
"VI",
"VT",
"WA",
"WI",
"WV",
"WY"
]
},
"postal_code": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5}(?:-\\d{4})?$"
},
{
"type": "null"
}
]
}
}
}
},
"minProperties": 1,
"maxProperties": 1
}
},
"options": {
"type": "integer",
"minimum": 1,
"maximum": 3,
"description": "Options per address, from 1 to 3, default 1. The nearest one or two stations are always included, so an answer can hold more options than requested."
},
"context": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"intent": {
"type": "string",
"enum": [
"buy",
"rent"
],
"description": "buy or rent, only if the user said so. Tailors the answer."
},
"budget_usd": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"min": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
"max": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
}
},
"minProperties": 1,
"description": "Budget range in whole US dollars, only if the user stated one. Does not change the answer yet."
},
"timeline": {
"type": "string",
"enum": [
"now",
"1_3_months",
"3_6_months",
"6_12_months",
"over_12_months"
],
"description": "How soon the user plans to move, only if stated. Does not change the answer."
},
"wants_agent_contact": {
"type": "boolean",
"description": "True only if the user asked to be connected with a listing agent. Returns the agent's contact when listing contact is enabled."
}
},
"minProperties": 1,
"description": "Optional. Fill only with facts the user volunteered. No names, contact details or chat text."
}
},
"required": [
"service_date",
"addresses"
],
"additionalProperties": false,
"description": "Up to 10 addresses answered for one dated query. Exactly one of window_id, arrive_by, or depart_after. arrive_by and depart_after accept a clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset (for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z). An omitted direction follows the window. An outbound requested time searches every downtown terminal unless terminal_id is set. Each address needs exactly one of address_id, address_text or components."
}出力スキーマ
{
"type": "object",
"$defs": {
"PublicAddress": {
"type": "object",
"additionalProperties": false,
"required": [
"address_id",
"site_id",
"kind",
"display_address",
"components",
"location_quality",
"indexable"
],
"properties": {
"address_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"site_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"building_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"kind": {
"type": "string",
"enum": [
"site",
"unit"
]
},
"display_address": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"components": {
"type": "object",
"additionalProperties": false,
"required": [
"house_number",
"street_predirectional",
"street_name",
"street_suffix",
"street_postdirectional",
"building_designator",
"building_value",
"unit_designator",
"unit_value",
"floor",
"postal_city",
"state",
"postal_code"
],
"properties": {
"house_number": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"street_predirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"street_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"street_suffix": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"street_postdirectional": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 16
},
{
"type": "null"
}
]
},
"building_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"building_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"unit_designator": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"unit_value": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32
},
{
"type": "null"
}
]
},
"postal_city": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "null"
}
]
},
"state": {
"type": "string",
"enum": [
"IL",
"WI"
]
},
"postal_code": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{5}(?:-\\d{4})?$"
},
{
"type": "null"
}
]
}
}
},
"municipality_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"location_quality": {
"type": "string",
"enum": [
"exact",
"interpolated",
"approximate",
"alias",
"candidate",
"review"
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"indexable": {
"type": "boolean"
},
"unit_caveat": {
"type": "string",
"enum": [
"unverified_unit"
]
}
}
},
"PublicCommuteBatch": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"results"
],
"properties": {
"schema_version": {
"const": 1
},
"results": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"index",
"status",
"result"
],
"properties": {
"index": {
"type": "integer",
"minimum": 0,
"maximum": 9
},
"status": {
"const": "ok"
},
"result": {
"$ref": "#/$defs/PublicCommuteResult"
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"index",
"status",
"error"
],
"properties": {
"index": {
"type": "integer",
"minimum": 0,
"maximum": 9
},
"status": {
"const": "error"
},
"error": {
"$ref": "#/$defs/PublicErrorEnvelope"
}
}
}
]
}
}
}
},
"PublicCommuteOption": {
"type": "object",
"additionalProperties": false,
"required": [
"station_id",
"station_name",
"route_id",
"route_name",
"terminal_id",
"terminal_name",
"trip_id",
"departure_at",
"departure_local",
"arrival_at",
"arrival_local",
"departure_s",
"arrival_s",
"drive_ms",
"drive_seconds",
"train_seconds",
"buffer_seconds",
"total_ms",
"total_seconds",
"total_minutes",
"express_class",
"group",
"traffic",
"other_arrivals",
"quality",
"limitations"
],
"properties": {
"station_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"station_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"station_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"route_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"route_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"terminal_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"terminal_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"terminal_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"trip_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"departure_at": {
"type": "string",
"format": "date-time"
},
"departure_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"arrival_at": {
"type": "string",
"format": "date-time"
},
"arrival_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"departure_s": {
"type": "integer",
"minimum": 0
},
"arrival_s": {
"type": "integer",
"minimum": 0
},
"drive_ms": {
"type": "integer",
"minimum": 0,
"maximum": 2700000
},
"drive_seconds": {
"type": "number",
"minimum": 0
},
"train_seconds": {
"type": "integer",
"minimum": 0
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800
},
"total_ms": {
"type": "integer",
"minimum": 0
},
"total_seconds": {
"type": "number",
"minimum": 0
},
"total_minutes": {
"type": "integer",
"minimum": 0
},
"express_class": {
"type": "string",
"enum": [
"local",
"limited",
"unknown"
]
},
"group": {
"type": "string",
"enum": [
"nearest",
"other"
]
},
"traffic": {
"const": "none"
},
"other_arrivals": {
"type": "array",
"maxItems": 80,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"trip_id",
"arrival_s",
"arrival_at",
"arrival_local"
],
"properties": {
"trip_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"arrival_s": {
"type": "integer",
"minimum": 0
},
"arrival_at": {
"type": "string",
"format": "date-time"
},
"arrival_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
}
}
}
},
"other_arrivals_text": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"quality": {
"type": "string",
"enum": [
"usable",
"approximate",
"review_required",
"invalid"
]
},
"limitations": {
"type": "array",
"maxItems": 5,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"approximate_origin",
"non_exact_timepoint",
"downtown_intermediate",
"train_over_24h",
"contact_unavailable"
]
}
},
"home_leave_at": {
"type": "string",
"format": "date-time"
},
"home_leave_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"home_arrive_at": {
"type": "string",
"format": "date-time"
},
"home_arrive_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"arrival_slack_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 86400
}
}
},
"PublicCommuteResult": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"address",
"versions",
"service_date",
"timezone",
"direction",
"buffer_seconds",
"status",
"options",
"service_notices",
"listing",
"methodology_url",
"warnings",
"source_credits"
],
"properties": {
"schema_version": {
"const": 1
},
"address": {
"$ref": "#/$defs/PublicAddress"
},
"versions": {
"$ref": "#/$defs/PublicVersions"
},
"service_date": {
"type": "string",
"format": "date"
},
"timezone": {
"const": "America/Chicago"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound"
]
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800
},
"status": {
"type": "string",
"enum": [
"ready",
"no_eligible_road_leg",
"no_service_in_window",
"summary_refreshing"
]
},
"options": {
"type": "array",
"maxItems": 5,
"items": {
"$ref": "#/$defs/PublicCommuteOption"
}
},
"service_notices": {
"type": "array",
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"station_id",
"station_name",
"route_id",
"group",
"code",
"text"
],
"properties": {
"station_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"station_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"route_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"group": {
"const": "nearest"
},
"code": {
"type": "string",
"enum": [
"no_saturday_service",
"no_sunday_service"
]
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
}
},
"listing": {
"$ref": "#/$defs/PublicListing"
},
"methodology_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"warnings": {
"type": "array",
"maxItems": 4,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"non_exact_timepoint",
"approximate_origin",
"contact_unavailable",
"train_horizon"
]
}
},
"source_credits": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"source_slug",
"attribution"
],
"properties": {
"source_slug": {
"type": "string",
"pattern": "^[a-z][a-z0-9-]{0,63}$"
},
"attribution": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
}
}
},
"PublicErrorEnvelope": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"error"
],
"properties": {
"schema_version": {
"const": 1
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"retryable",
"request_id"
],
"properties": {
"code": {
"type": "string",
"enum": [
"PUBLIC_ADDRESS_AMBIGUOUS",
"PUBLIC_CAPACITY_UNAVAILABLE",
"PUBLIC_CONTACT_UNAVAILABLE",
"PUBLIC_CURSOR_EXPIRED",
"PUBLIC_CURSOR_INVALID",
"PUBLIC_DATA_UNAVAILABLE",
"PUBLIC_INVALID_ARGUMENT",
"PUBLIC_NOT_FOUND",
"PUBLIC_NO_SERVICE",
"PUBLIC_OUT_OF_COVERAGE",
"PUBLIC_PLACE_AMBIGUOUS",
"PUBLIC_RATE_LIMITED",
"PUBLIC_SCHEDULE_UNAVAILABLE",
"PUBLIC_SEARCH_TOO_BROAD",
"PUBLIC_STATION_AMBIGUOUS",
"PUBLIC_STATION_NOT_FOUND",
"PUBLIC_VERSION_UNSUPPORTED"
]
},
"message": {
"type": "string",
"enum": [
"More than one address matches.",
"Capacity is unavailable.",
"Listing contact is unavailable.",
"The page cursor has expired.",
"The page cursor is not valid.",
"Public data is unavailable.",
"The request is not valid.",
"No public record is available.",
"No service is available for that request.",
"That address is outside Commlo coverage.",
"More than one place matches.",
"The request rate is limited.",
"Schedule data is unavailable.",
"The search is too broad.",
"More than one station matches.",
"No Metra station matches that name or ID exactly. Any close matches are listed.",
"This contract version is not supported."
]
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"valid_from": {
"type": "string",
"format": "date"
},
"valid_through": {
"type": "string",
"format": "date"
},
"detail": {
"type": "object",
"additionalProperties": false,
"required": [
"field",
"reason",
"expected"
],
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"expected": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
}
},
"candidates": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"kind",
"id",
"display"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"address",
"station",
"place"
]
},
"id": {
"type": "string"
},
"display": {
"type": "string",
"maxLength": 200
}
}
}
}
}
},
"PublicListing": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"address_id",
"status",
"source",
"effective_at",
"observed_at",
"valid_until",
"representation",
"contact",
"co_listing_contacts",
"attribution",
"projection_version"
],
"properties": {
"schema_version": {
"const": 1
},
"address_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"status": {
"type": "string",
"enum": [
"active",
"pending",
"sold",
"off_market",
"unknown"
]
},
"source": {
"anyOf": [
{
"type": "string",
"enum": [
"agent_reported",
"idx_own_listing",
"mls_grid",
"idx_observed"
]
},
{
"type": "null"
}
]
},
"effective_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"effective_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"observed_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"valid_until": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
]
},
"valid_until_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"representation": {
"type": "string",
"enum": [
"current",
"none"
]
},
"contact": {
"anyOf": [
{
"$ref": "#/$defs/PublicListingContact"
},
{
"type": "null"
}
]
},
"co_listing_contacts": {
"type": "array",
"maxItems": 4,
"items": {
"$ref": "#/$defs/PublicListingContact"
}
},
"attribution": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"projection_version": {
"type": "string",
"pattern": "^(?:0|[1-9][0-9]{0,18})$"
}
}
},
"PublicListingContact": {
"type": "object",
"additionalProperties": false,
"required": [
"directory_contact_id",
"display_name",
"brokerage_name",
"verification",
"verified_at",
"verified_local",
"business_phone",
"business_website",
"disclosure"
],
"properties": {
"directory_contact_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"display_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"brokerage_name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"verification": {
"type": "string",
"enum": [
"identity_verified",
"provider_attributed"
]
},
"verified_at": {
"type": "string",
"format": "date-time"
},
"verified_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"business_phone": {
"anyOf": [
{
"type": "string",
"minLength": 7,
"maxLength": 32
},
{
"type": "null"
}
]
},
"business_website": {
"anyOf": [
{
"type": "string",
"format": "uri",
"pattern": "^https://"
},
{
"type": "null"
}
]
},
"disclosure": {
"const": "represents_seller"
}
}
},
"PublicVersions": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"catalog_version",
"corpus_version",
"road_version",
"graph_version",
"train_version",
"methodology_version",
"station_access_version",
"computed_at",
"computed_local",
"published_at",
"published_local",
"train_valid_from",
"train_valid_through"
],
"properties": {
"schema_version": {
"const": 1
},
"catalog_version": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"corpus_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"road_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"graph_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"train_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"methodology_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"station_access_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"computed_at": {
"type": "string",
"format": "date-time"
},
"computed_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"train_valid_from": {
"type": "string",
"format": "date"
},
"train_valid_through": {
"type": "string",
"format": "date"
}
}
}
},
"oneOf": [
{
"$ref": "#/$defs/PublicCommuteBatch"
},
{
"$ref": "#/$defs/PublicErrorEnvelope"
}
]
}🟢station_info(station_id, name, service_date, direction, terminal_id, ...)
Facts about one Metra station on one service date, by station ID or name: its routes, the downtown Chicago terminals it serves and facility links when known.
入力スキーマ
{
"type": "object",
"properties": {
"station_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"service_date": {
"type": "string",
"format": "date"
},
"direction": {
"type": "string",
"enum": [
"inbound",
"outbound"
]
},
"terminal_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"window_id": {
"type": "string",
"enum": [
"inbound_am",
"outbound_pm",
"inbound_offpeak",
"outbound_offpeak",
"weekend_daytime",
"early_late"
]
},
"arrive_by": {
"type": "string",
"minLength": 4,
"description": "A clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset, for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z."
},
"depart_after": {
"type": "string",
"minLength": 4,
"description": "A clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset, for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z."
},
"buffer_seconds": {
"type": "integer",
"minimum": 0,
"maximum": 1800,
"default": 300
},
"context": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"intent": {
"type": "string",
"enum": [
"buy",
"rent"
],
"description": "buy or rent, only if the user said so. Tailors the answer."
},
"budget_usd": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"min": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
},
"max": {
"type": "integer",
"minimum": 0,
"maximum": 100000000
}
},
"minProperties": 1,
"description": "Budget range in whole US dollars, only if the user stated one. Does not change the answer yet."
},
"timeline": {
"type": "string",
"enum": [
"now",
"1_3_months",
"3_6_months",
"6_12_months",
"over_12_months"
],
"description": "How soon the user plans to move, only if stated. Does not change the answer."
},
"wants_agent_contact": {
"type": "boolean",
"description": "True only if the user asked to be connected with a listing agent. Returns the agent's contact when listing contact is enabled."
}
},
"minProperties": 1,
"description": "Optional. Fill only with facts the user volunteered. No names, contact details or chat text."
}
},
"required": [
"service_date"
],
"additionalProperties": false,
"description": "station_id XOR name. Exactly one of window_id, arrive_by, or depart_after. arrive_by and depart_after accept a clock time on the service date (H:MM, HH:MM, or HH:MM:SS in America/Chicago) or an RFC 3339 date-time with an offset (for example 09:00, 2026-11-12T09:00:00-06:00, or 2026-11-12T15:00:00Z). An omitted direction follows the window (outbound_pm and outbound_offpeak are outbound; other windows and requested times stay inbound). An outbound requested time searches every downtown terminal unless terminal_id is set."
}出力スキーマ
{
"type": "object",
"$defs": {
"PublicErrorEnvelope": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"error"
],
"properties": {
"schema_version": {
"const": 1
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"retryable",
"request_id"
],
"properties": {
"code": {
"type": "string",
"enum": [
"PUBLIC_ADDRESS_AMBIGUOUS",
"PUBLIC_CAPACITY_UNAVAILABLE",
"PUBLIC_CONTACT_UNAVAILABLE",
"PUBLIC_CURSOR_EXPIRED",
"PUBLIC_CURSOR_INVALID",
"PUBLIC_DATA_UNAVAILABLE",
"PUBLIC_INVALID_ARGUMENT",
"PUBLIC_NOT_FOUND",
"PUBLIC_NO_SERVICE",
"PUBLIC_OUT_OF_COVERAGE",
"PUBLIC_PLACE_AMBIGUOUS",
"PUBLIC_RATE_LIMITED",
"PUBLIC_SCHEDULE_UNAVAILABLE",
"PUBLIC_SEARCH_TOO_BROAD",
"PUBLIC_STATION_AMBIGUOUS",
"PUBLIC_STATION_NOT_FOUND",
"PUBLIC_VERSION_UNSUPPORTED"
]
},
"message": {
"type": "string",
"enum": [
"More than one address matches.",
"Capacity is unavailable.",
"Listing contact is unavailable.",
"The page cursor has expired.",
"The page cursor is not valid.",
"Public data is unavailable.",
"The request is not valid.",
"No public record is available.",
"No service is available for that request.",
"That address is outside Commlo coverage.",
"More than one place matches.",
"The request rate is limited.",
"Schedule data is unavailable.",
"The search is too broad.",
"More than one station matches.",
"No Metra station matches that name or ID exactly. Any close matches are listed.",
"This contract version is not supported."
]
},
"retryable": {
"type": "boolean"
},
"request_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"retry_after_seconds": {
"type": "integer",
"minimum": 1
},
"valid_from": {
"type": "string",
"format": "date"
},
"valid_through": {
"type": "string",
"format": "date"
},
"detail": {
"type": "object",
"additionalProperties": false,
"required": [
"field",
"reason",
"expected"
],
"properties": {
"field": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"expected": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
}
},
"candidates": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"kind",
"id",
"display"
],
"properties": {
"kind": {
"type": "string",
"enum": [
"address",
"station",
"place"
]
},
"id": {
"type": "string"
},
"display": {
"type": "string",
"maxLength": 200
}
}
}
}
}
},
"PublicStation": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"station_id",
"station_name",
"lon",
"lat",
"routes",
"terminal_services",
"facility_urls",
"versions"
],
"properties": {
"schema_version": {
"const": 1
},
"station_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"station_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"canonical_url": {
"type": "string",
"format": "uri",
"pattern": "^https://"
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"municipality_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"routes": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"route_id",
"route_name"
],
"properties": {
"route_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"route_name": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
}
}
},
"terminal_services": {
"type": "array",
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"terminal_id",
"name"
],
"properties": {
"terminal_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9_-]{0,63}$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
}
}
},
"facility_urls": {
"type": "array",
"maxItems": 5,
"uniqueItems": true,
"items": {
"type": "string",
"format": "uri",
"pattern": "^https://"
}
},
"versions": {
"$ref": "#/$defs/PublicVersions"
}
}
},
"PublicVersions": {
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"catalog_version",
"corpus_version",
"road_version",
"graph_version",
"train_version",
"methodology_version",
"station_access_version",
"computed_at",
"computed_local",
"published_at",
"published_local",
"train_valid_from",
"train_valid_through"
],
"properties": {
"schema_version": {
"const": 1
},
"catalog_version": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"corpus_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"road_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"graph_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"train_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"methodology_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"station_access_version": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"computed_at": {
"type": "string",
"format": "date-time"
},
"computed_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_local": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}[+-]\\d{2}:\\d{2}$"
},
"train_valid_from": {
"type": "string",
"format": "date"
},
"train_valid_through": {
"type": "string",
"format": "date"
}
}
}
},
"oneOf": [
{
"$ref": "#/$defs/PublicStation"
},
{
"$ref": "#/$defs/PublicErrorEnvelope"
}
]
}コミュニティ
エビデンス