plan_trotro_routePlan trotro journeys in Ghana, including fares, walking legs, transfers, and boarding instructions. Prefer plan_public_transport, which also covers buses in Great Britain.
| Name | Required | Description | Default |
|---|---|---|---|
| pickup | Yes | Pickup coordinates | |
| destination | Yes | Destination coordinates |
| Name | Required | Description | Default |
|---|---|---|---|
| routes | Yes | ||
| complete | Yes | ||
| skipNote | No | ||
| routeCounts | Yes | ||
| routesRequiringRideConnection | Yes |
Changes observed during successful MCP inspections.
Output schema / properties / routes / items / properties / steps / items / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "distanceMeters": {
- "type": "number"
- },
- "durationMinutes": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "roadCrossings": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "distanceFromStartMeters": {
- "minimum": 0,
- "type": "number"
- },
- "evidence": {
- "enum": [
- "mapped-crossing",
- "short-road-traversal"
- ],
- "type": "string"
- },
- "location": {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "description": "Latitude in decimal degrees",
- "maximum": 90,
- "minimum": -90,
- "type": "number"
- },
- "lng": {
- "description": "Longitude in decimal degrees",
- "maximum": 180,
- "minimum": -180,
- "type": "number"
- }
- },
- "required": [
- "lat",
- "lng"
- ],
- "type": "object"
- }
- },
- "required": [
- "location",
- "distanceFromStartMeters",
- "evidence",
- "confidence"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "roadCrossingsTotal": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "roadCrossingsTruncated": {
- "type": "boolean"
- },
- "toStop": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "type": {
- "const": "walk",
- "type": "string"
- },
- "unverifiedEndpointMeters": {
- "minimum": 0,
- "type": "number"
- }
- },
- "required": [
- "type",
- "toStop"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "alightAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "alightingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "boardAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "boardingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "currency": {
- "type": "string"
- },
- "fare": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "route": {
- "type": "string"
- },
- "stopCount": {
- "type": "number"
- },
- "toward": {
- "type": "string"
- },
- "type": {
- "const": "ride",
- "type": "string"
- }
- },
- "required": [
- "type",
- "boardAt",
- "alightAt"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "directDistanceOnly": {
+ "const": true,
+ "description": "The walk could not be mapped, so its distance is the straight-line distance.",
+ "type": "boolean"
+ },
+ "distanceMeters": {
+ "type": "number"
+ },
+ "durationMinutes": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "roadCrossings": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "distanceFromStartMeters": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "evidence": {
+ "enum": [
+ "mapped-crossing",
+ "short-road-traversal"
+ ],
+ "type": "string"
+ },
+ "location": {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "description": "Latitude in decimal degrees",
+ "maximum": 90,
+ "minimum": -90,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude in decimal degrees",
+ "maximum": 180,
+ "minimum": -180,
+ "type": "number"
+ }
+ },
+ "required": [
+ "lat",
+ "lng"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "location",
+ "distanceFromStartMeters",
+ "evidence",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "roadCrossingsTotal": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "roadCrossingsTruncated": {
+ "type": "boolean"
+ },
+ "toStop": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "const": "walk",
+ "type": "string"
+ },
+ "unverifiedEndpointMeters": {
+ "minimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "toStop"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "alightAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "alightingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "boardAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "boardingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "currency": {
+ "type": "string"
+ },
+ "fare": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "route": {
+ "type": "string"
+ },
+ "stopCount": {
+ "type": "number"
+ },
+ "toward": {
+ "type": "string"
+ },
+ "type": {
+ "const": "ride",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "boardAt",
+ "alightAt"
+ ],
+ "type": "object"
+ }
+]Output schema / properties / routesRequiringRideConnection / items / properties / steps / items / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "distanceMeters": {
- "type": "number"
- },
- "durationMinutes": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "roadCrossings": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "distanceFromStartMeters": {
- "minimum": 0,
- "type": "number"
- },
- "evidence": {
- "enum": [
- "mapped-crossing",
- "short-road-traversal"
- ],
- "type": "string"
- },
- "location": {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "description": "Latitude in decimal degrees",
- "maximum": 90,
- "minimum": -90,
- "type": "number"
- },
- "lng": {
- "description": "Longitude in decimal degrees",
- "maximum": 180,
- "minimum": -180,
- "type": "number"
- }
- },
- "required": [
- "lat",
- "lng"
- ],
- "type": "object"
- }
- },
- "required": [
- "location",
- "distanceFromStartMeters",
- "evidence",
- "confidence"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "roadCrossingsTotal": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "roadCrossingsTruncated": {
- "type": "boolean"
- },
- "toStop": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "type": {
- "const": "walk",
- "type": "string"
- },
- "unverifiedEndpointMeters": {
- "minimum": 0,
- "type": "number"
- }
- },
- "required": [
- "type",
- "toStop"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "alightAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "alightingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "boardAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "boardingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "currency": {
- "type": "string"
- },
- "fare": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "route": {
- "type": "string"
- },
- "stopCount": {
- "type": "number"
- },
- "toward": {
- "type": "string"
- },
- "type": {
- "const": "ride",
- "type": "string"
- }
- },
- "required": [
- "type",
- "boardAt",
- "alightAt"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "directDistanceOnly": {
+ "const": true,
+ "description": "The walk could not be mapped, so its distance is the straight-line distance.",
+ "type": "boolean"
+ },
+ "distanceMeters": {
+ "type": "number"
+ },
+ "durationMinutes": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "roadCrossings": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "distanceFromStartMeters": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "evidence": {
+ "enum": [
+ "mapped-crossing",
+ "short-road-traversal"
+ ],
+ "type": "string"
+ },
+ "location": {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "description": "Latitude in decimal degrees",
+ "maximum": 90,
+ "minimum": -90,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude in decimal degrees",
+ "maximum": 180,
+ "minimum": -180,
+ "type": "number"
+ }
+ },
+ "required": [
+ "lat",
+ "lng"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "location",
+ "distanceFromStartMeters",
+ "evidence",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "roadCrossingsTotal": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "roadCrossingsTruncated": {
+ "type": "boolean"
+ },
+ "toStop": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "const": "walk",
+ "type": "string"
+ },
+ "unverifiedEndpointMeters": {
+ "minimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "toStop"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "alightAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "alightingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "boardAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "boardingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "currency": {
+ "type": "string"
+ },
+ "fare": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "route": {
+ "type": "string"
+ },
+ "stopCount": {
+ "type": "number"
+ },
+ "toward": {
+ "type": "string"
+ },
+ "type": {
+ "const": "ride",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "boardAt",
+ "alightAt"
+ ],
+ "type": "object"
+ }
+]Output schema / properties / routes / items / properties / arrivalTimeAdded value: +{
+ "type": "string"
+}Output schema / properties / routes / items / properties / departureTimeAdded value: +{
+ "type": "string"
+}Output schema / properties / routes / items / properties / fareRangeAdded value: +{
+ "additionalProperties": false,
+ "properties": {
+ "max": {
+ "type": "number"
+ },
+ "min": {
+ "type": "number"
+ }
+ },
+ "required": [
+ "min",
+ "max"
+ ],
+ "type": "object"
+}Output schema / properties / routes / items / properties / segments / items / properties / arrivalTimeAdded value: +{
+ "description": "Timetabled bus arrival, ISO 8601",
+ "type": "string"
+}Output schema / properties / routes / items / properties / segments / items / properties / departureTimeAdded value: +{
+ "description": "Timetabled bus departure, ISO 8601",
+ "type": "string"
+}Output schema / properties / routes / items / properties / segments / items / properties / fareBasisAdded value: +{
+ "description": "How the bus fare was set: the operator's published single, a local flat fare, an estimate at England's national fare cap, or unavailable",
+ "enum": [
+ "operator-published",
+ "local-flat-fare",
+ "national-fare-cap-estimate",
+ "unavailable"
+ ],
+ "type": "string"
+}Output schema / properties / routes / items / properties / segments / items / properties / fareMinAdded value: +{
+ "description": "Lowest listed bus fare when the operator lists several",
+ "type": "number"
+}Output schema / properties / routes / items / properties / timeZoneAdded value: +{
+ "type": "string"
+}Output schema / properties / routesRequiringRideConnection / items / properties / arrivalTimeAdded value: +{
+ "type": "string"
+}Output schema / properties / routesRequiringRideConnection / items / properties / departureTimeAdded value: +{
+ "type": "string"
+}Output schema / properties / routesRequiringRideConnection / items / properties / fareRangeAdded value: +{
+ "additionalProperties": false,
+ "properties": {
+ "max": {
+ "type": "number"
+ },
+ "min": {
+ "type": "number"
+ }
+ },
+ "required": [
+ "min",
+ "max"
+ ],
+ "type": "object"
+}Output schema / properties / routesRequiringRideConnection / items / properties / segments / items / properties / arrivalTimeAdded value: +{
+ "description": "Timetabled bus arrival, ISO 8601",
+ "type": "string"
+}Output schema / properties / routesRequiringRideConnection / items / properties / segments / items / properties / departureTimeAdded value: +{
+ "description": "Timetabled bus departure, ISO 8601",
+ "type": "string"
+}Output schema / properties / routesRequiringRideConnection / items / properties / segments / items / properties / fareBasisAdded value: +{
+ "description": "How the bus fare was set: the operator's published single, a local flat fare, an estimate at England's national fare cap, or unavailable",
+ "enum": [
+ "operator-published",
+ "local-flat-fare",
+ "national-fare-cap-estimate",
+ "unavailable"
+ ],
+ "type": "string"
+}Output schema / properties / routesRequiringRideConnection / items / properties / segments / items / properties / fareMinAdded value: +{
+ "description": "Lowest listed bus fare when the operator lists several",
+ "type": "number"
+}Output schema / properties / routesRequiringRideConnection / items / properties / timeZoneAdded value: +{
+ "type": "string"
+}Output schema / properties / routes / items / properties / steps / items / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "distanceMeters": {
- "type": "number"
- },
- "durationMinutes": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "roadCrossings": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "distanceFromStartMeters": {
- "minimum": 0,
- "type": "number"
- },
- "evidence": {
- "enum": [
- "mapped-crossing",
- "short-road-traversal"
- ],
- "type": "string"
- },
- "location": {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "description": "Latitude in decimal degrees",
- "maximum": 90,
- "minimum": -90,
- "type": "number"
- },
- "lng": {
- "description": "Longitude in decimal degrees",
- "maximum": 180,
- "minimum": -180,
- "type": "number"
- }
- },
- "required": [
- "lat",
- "lng"
- ],
- "type": "object"
- }
- },
- "required": [
- "location",
- "distanceFromStartMeters",
- "evidence",
- "confidence"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "roadCrossingsTotal": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "roadCrossingsTruncated": {
- "type": "boolean"
- },
- "toStop": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "type": {
- "const": "walk",
- "type": "string"
- }
- },
- "required": [
- "type",
- "toStop"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "alightAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "alightingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "boardAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "boardingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "currency": {
- "type": "string"
- },
- "fare": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "route": {
- "type": "string"
- },
- "stopCount": {
- "type": "number"
- },
- "toward": {
- "type": "string"
- },
- "type": {
- "const": "ride",
- "type": "string"
- }
- },
- "required": [
- "type",
- "boardAt",
- "alightAt"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "distanceMeters": {
+ "type": "number"
+ },
+ "durationMinutes": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "roadCrossings": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "distanceFromStartMeters": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "evidence": {
+ "enum": [
+ "mapped-crossing",
+ "short-road-traversal"
+ ],
+ "type": "string"
+ },
+ "location": {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "description": "Latitude in decimal degrees",
+ "maximum": 90,
+ "minimum": -90,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude in decimal degrees",
+ "maximum": 180,
+ "minimum": -180,
+ "type": "number"
+ }
+ },
+ "required": [
+ "lat",
+ "lng"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "location",
+ "distanceFromStartMeters",
+ "evidence",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "roadCrossingsTotal": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "roadCrossingsTruncated": {
+ "type": "boolean"
+ },
+ "toStop": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "const": "walk",
+ "type": "string"
+ },
+ "unverifiedEndpointMeters": {
+ "minimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "toStop"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "alightAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "alightingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "boardAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "boardingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "currency": {
+ "type": "string"
+ },
+ "fare": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "route": {
+ "type": "string"
+ },
+ "stopCount": {
+ "type": "number"
+ },
+ "toward": {
+ "type": "string"
+ },
+ "type": {
+ "const": "ride",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "boardAt",
+ "alightAt"
+ ],
+ "type": "object"
+ }
+]Output schema / properties / routesRequiringRideConnection / items / properties / steps / items / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "distanceMeters": {
- "type": "number"
- },
- "durationMinutes": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "roadCrossings": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "distanceFromStartMeters": {
- "minimum": 0,
- "type": "number"
- },
- "evidence": {
- "enum": [
- "mapped-crossing",
- "short-road-traversal"
- ],
- "type": "string"
- },
- "location": {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "description": "Latitude in decimal degrees",
- "maximum": 90,
- "minimum": -90,
- "type": "number"
- },
- "lng": {
- "description": "Longitude in decimal degrees",
- "maximum": 180,
- "minimum": -180,
- "type": "number"
- }
- },
- "required": [
- "lat",
- "lng"
- ],
- "type": "object"
- }
- },
- "required": [
- "location",
- "distanceFromStartMeters",
- "evidence",
- "confidence"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "roadCrossingsTotal": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "roadCrossingsTruncated": {
- "type": "boolean"
- },
- "toStop": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "type": {
- "const": "walk",
- "type": "string"
- }
- },
- "required": [
- "type",
- "toStop"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "alightAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "alightingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "boardAt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "lat": {
- "type": "number"
- },
- "lng": {
- "type": "number"
- },
- "name": {
- "type": "string"
- }
- },
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "boardingRoadCrossing": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "confidence": {
- "const": "high",
- "type": "string"
- },
- "status": {
- "const": "required",
- "type": "string"
- }
- },
- "required": [
- "status",
- "confidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "status": {
- "const": "unknown",
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- }
- ]
- },
- "currency": {
- "type": "string"
- },
- "fare": {
- "type": "number"
- },
- "instruction": {
- "type": "string"
- },
- "route": {
- "type": "string"
- },
- "stopCount": {
- "type": "number"
- },
- "toward": {
- "type": "string"
- },
- "type": {
- "const": "ride",
- "type": "string"
- }
- },
- "required": [
- "type",
- "boardAt",
- "alightAt"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "distanceMeters": {
+ "type": "number"
+ },
+ "durationMinutes": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "roadCrossings": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "distanceFromStartMeters": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "evidence": {
+ "enum": [
+ "mapped-crossing",
+ "short-road-traversal"
+ ],
+ "type": "string"
+ },
+ "location": {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "description": "Latitude in decimal degrees",
+ "maximum": 90,
+ "minimum": -90,
+ "type": "number"
+ },
+ "lng": {
+ "description": "Longitude in decimal degrees",
+ "maximum": 180,
+ "minimum": -180,
+ "type": "number"
+ }
+ },
+ "required": [
+ "lat",
+ "lng"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "location",
+ "distanceFromStartMeters",
+ "evidence",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "roadCrossingsTotal": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "roadCrossingsTruncated": {
+ "type": "boolean"
+ },
+ "toStop": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "const": "walk",
+ "type": "string"
+ },
+ "unverifiedEndpointMeters": {
+ "minimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "type",
+ "toStop"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "alightAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "alightingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "boardAt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "lat": {
+ "type": "number"
+ },
+ "lng": {
+ "type": "number"
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "boardingRoadCrossing": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "confidence": {
+ "const": "high",
+ "type": "string"
+ },
+ "status": {
+ "const": "required",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "confidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "const": "unknown",
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "currency": {
+ "type": "string"
+ },
+ "fare": {
+ "type": "number"
+ },
+ "instruction": {
+ "type": "string"
+ },
+ "route": {
+ "type": "string"
+ },
+ "stopCount": {
+ "type": "number"
+ },
+ "toward": {
+ "type": "string"
+ },
+ "type": {
+ "const": "ride",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "boardAt",
+ "alightAt"
+ ],
+ "type": "object"
+ }
+]Output schema / properties / skipNoteAdded value: +{
+ "type": "string"
+}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint=false, so safety is covered. The description adds genuinely new behavioral context: that results include fares, walking legs, transfers, and boarding instructions, telling the agent what a successful call yields beyond a bare route. It stops short of noting coverage limits within Ghana or failure modes for out-of-area coordinates.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, zero filler, with the capability and scope stated first and the routing hint second. Every clause conveys information the agent needs.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present and rich annotations, the description need not explain return values, and its enumerations of fares and transfers plus the geographic scope make it callable as written. The only gap is unresolved ambiguity about whether plan_public_transport also serves Ghana, which affects tool selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with nested lat/lng objects, each property documented with type, bounds, and meaning. The description adds no additional semantics about the coordinates (no format hints, no note that both points must be in Ghana), so the schema does all the work.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource (plan trotro journeys), scopes it geographically (Ghana), and enumerates what the plan contains: fares, walking legs, transfers, and boarding instructions. An agent can distinguish it from plan_public_transport and plan_trip without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly names the alternative (plan_public_transport) and states a preference for it, which is real routing guidance rather than vague context. However, it never says when THIS tool is the right choice (that is, when trotro-specific detail or Ghana coverage requires it over the general planner), so the agent must infer that.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.