Ridesharing Service Entity

v2.0.1
Service
Ridesharing Services

Schema for ridesharing services and ride-hailing platforms. Designed for AI agents to understand transportation services, safety features, and booking capabilities.

Entity Hierarchy
RidesharingService
service
ridesharing_services
ridesharing_service

Format: @type → entityCategory → subcategory → entityType

2

Required Modules

3

Recommended Modules

12+

Functional Features

8

Site Actions

⭐ New Fields v2.0.1
Perfect AI understanding with zero ambiguity

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 Modules
Essential modules for ridesharing service entities
Required
auth

REQUIRED - User authentication and verification

Essential for rider and driver identity verification

Required
location

REQUIRED - GPS tracking and location services

Core functionality for ride matching and navigation

Recommended Modules
Enhance ridesharing service functionality and user experience
Recommended
payments
Recommended
user-management
Recommended
notification
Entity Capabilities
Objective, verifiable ridesharing service features and capabilities. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".
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

hasRealTimeMatching

Real-time driver-rider matching

hasAdvanceBooking

Schedule rides in advance

hasMultipleStops

Support for multiple destinations

hasRideSharing

Shared ride options

Safety & Security

hasEmergencyButton

Emergency assistance button

hasTripVerification

Trip verification (PIN codes)

hasDriverVerification

Background check system

hasGPSTracking

Real-time location tracking

Technology Features

hasRouteOptimization

AI-powered route optimization

hasPredictiveArrival

Predictive arrival times

hasDriverRating

Driver rating system

hasCashlessPayment

Digital payment processing

Site Capabilities
Available actions for AI agents and automated systems. Define what users can actually do on your website using snake_case action names.
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_ride

Request an immediate ride

schedule_ride

Schedule future rides

track_driver

Track driver location in real-time

rate_driver

Rate and review driver

view_ride_history

Access past ride records

manage_payment

Manage payment methods

contact_support

Access customer support

estimate_fare

Get ride cost estimates

Schema Structure
Ridesharing service entity schema definition
ridesharing_service.json
{
  "$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" }]
}
Complete Implementation Example
Real-world ridesharing service entity with all v2.0.1 features
SwiftRide - Complete Schema
{
  "@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"]
  }
}
Schema URL
Direct access to the ridesharing service entity schema
https://schemas.meta-aiml.org/v2.0.1/entity/ridesharing_service.json

Inherits from service base schema via allOf reference