Ridesharing Service Entity
Schema for ridesharing services and ride-hailing platforms. Designed for AI agents to understand transportation services, safety features, and booking capabilities.
Format: @type → entityCategory → subcategory → entityType
Required Modules
Recommended Modules
Functional Features
Site Actions
entityCapabilities
Objective capabilities of the business with rules:
- • camelCase (hasRealTimeMatching, hasEmergencyButton)
- • Prefixes: has, is, accepts, supports
- • Boolean values for objective verification
- • Examples expandable - no limitations
siteCapabilities
Actions available on website with rules:
- • snake_case (book_ride, track_driver)
- • Based on verbs (what users can do)
- • Only actually working actions
- • Examples expandable without limitations
REQUIRED - User authentication and verification
Essential for rider and driver identity verification
REQUIRED - GPS tracking and location services
Core functionality for ride matching and navigation
Naming Convention Rules
- • Use camelCase formatting (e.g., "hasRealTimeMatching", "hasEmergencyButton")
- • Start with prefixes: "has", "is", "accepts", "supports"
- • Examples shown below can be extended - no limitations on additional capabilities
- • All values are boolean (true/false) for objective verification
Ride Management
hasRealTimeMatchingReal-time driver-rider matching
hasAdvanceBookingSchedule rides in advance
hasMultipleStopsSupport for multiple destinations
hasRideSharingShared ride options
Safety & Security
hasEmergencyButtonEmergency assistance button
hasTripVerificationTrip verification (PIN codes)
hasDriverVerificationBackground check system
hasGPSTrackingReal-time location tracking
Technology Features
hasRouteOptimizationAI-powered route optimization
hasPredictiveArrivalPredictive arrival times
hasDriverRatingDriver rating system
hasCashlessPaymentDigital payment processing
Action Naming Rules
- • Use snake_case formatting (e.g., "book_ride", "track_driver")
- • Actions should be verb-based describing what users can do
- • Examples shown below are common patterns - extend with your specific actions
- • List only actions that actually work on your website
book_rideRequest an immediate ride
schedule_rideSchedule future rides
track_driverTrack driver location in real-time
rate_driverRate and review driver
view_ride_historyAccess past ride records
manage_paymentManage payment methods
contact_supportAccess customer support
estimate_fareGet ride cost estimates
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"aimlVersion": "2.0.1",
"schemaVersion": "2.0.1",
"title": "Ridesharing Service Entity Schema",
"description": "Schema for ridesharing services and ride-hailing platforms",
"type": "object",
"properties": {
"entityType": {
"const": "ridesharing_service",
"description": "Entity type identifier"
},
"entityCategory": {
"const": "service",
"description": "Entity category"
},
"subcategory": {
"const": "ridesharing_services",
"description": "Subcategory of service"
},
"name": {
"oneOf": [
{ "type": "string" },
{ "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
],
"description": "Ridesharing service name"
},
"description": {
"oneOf": [
{ "type": "string" },
{ "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
],
"description": "Detailed description of the ridesharing service"
},
"modules": {
"type": "object",
"description": "AIML modules used by this entity"
},
"properties": {
"type": "object",
"description": "Ridesharing service specific properties",
"properties": {
"serviceType": {
"type": "string",
"enum": [
"ridesharing", "carpooling", "taxi-hailing",
"micromobility", "multi-modal", "corporate", "specialized"
]
},
"vehicleTypes": {
"type": "array",
"items": {
"type": "string",
"enum": ["standard", "economy", "premium", "luxury", "SUV", "van", "accessible", "electric", "hybrid", "bike", "scooter", "motorcycle"]
}
}
}
},
"entityCapabilities": {
"$ref": "../components/entity-capabilities-format.json#/$defs/EntityCapabilities",
"description": "Objective capabilities and features of the entity"
},
"siteCapabilities": {
"$ref": "../components/site-capabilities-format.json#/$defs/SiteCapabilities",
"description": "Website capabilities and interaction features"
}
},
"required": ["entityType", "entityCategory", "subcategory", "name", "description", "properties"],
"allOf": [{ "$ref": "../base/service.json" }]
}{
"@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
"@id": "https://swiftride.com/entity",
"@type": "RidesharingService",
"schemaVersion": "2.0.1",
"entityType": "ridesharing_service",
"entityCategory": "service",
"subcategory": "ridesharing_services",
"name": {
"en": "SwiftRide",
"es": "SwiftRide",
"fr": "SwiftRide"
},
"description": {
"en": "Modern ridesharing platform connecting riders and drivers with real-time matching, multiple vehicle options, and safety-first approach."
},
"url": "https://swiftride.com",
"properties": {
"serviceType": "ridesharing",
"vehicleTypes": ["standard", "premium", "SUV", "electric"],
"operatingRegions": ["North America", "Europe"],
"businessModel": ["commission-based", "subscription"],
"serviceTypes": ["on-demand rides", "scheduled rides", "airport transfer"]
},
"modules": {
"auth": {
"version": "2.0.1",
"enabled": true,
"methods": ["phone", "email", "social"]
},
"location": {
"version": "2.0.1",
"enabled": true,
"features": ["gps_tracking", "route_optimization", "geofencing"]
},
"payments": {
"version": "2.0.1",
"enabled": true,
"providers": ["stripe", "paypal"],
"methods": ["credit_card", "mobile_payment", "in_app_wallet"]
},
"notification": {
"version": "2.0.1",
"enabled": true,
"channels": ["push", "sms", "email"]
}
},
"entityCapabilities": {
"functionalFeatures": {
"hasRealTimeMatching": true,
"hasAdvanceBooking": true,
"hasMultipleStops": true,
"hasRideSharing": true,
"hasEmergencyButton": true,
"hasTripVerification": true,
"hasRouteOptimization": true,
"hasPredictiveArrival": true,
"hasDriverRating": true,
"hasRiderRating": true,
"hasCashlessPayment": true,
"has24hSupport": true
},
"contentTypes": ["ride_history", "driver_profiles", "pricing", "safety_info", "support"],
"businessModel": "ridesharing_platform",
"serviceTypes": ["on_demand_rides", "scheduled_rides", "shared_rides", "premium_rides"],
"targetAudience": ["urban_commuters", "travelers", "business_users", "occasional_riders"],
"safetyFeatures": ["driver_verification", "gps_tracking", "emergency_assistance", "ride_monitoring"]
},
"siteCapabilities": {
"availableActions": [
"book_ride", "schedule_ride", "track_driver",
"rate_driver", "view_ride_history", "manage_payment",
"contact_support", "share_ride", "estimate_fare"
],
"interactionMethods": ["mobile_app", "web_platform", "phone_booking"],
"contentAccess": ["public_pricing", "user_account", "driver_portal"],
"supportedDevices": ["mobile", "tablet", "desktop"],
"languages": ["en", "es", "fr"],
"realTimeFeatures": ["live_tracking", "instant_matching", "real_time_eta"]
}
}https://schemas.meta-aiml.org/v2.0.1/entity/ridesharing_service.jsonInherits from service base schema via allOf reference