{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/ridesharing_service/cityloop-mobility",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/ridesharing_service/cityloop-mobility",
  "@type": "RidesharingService",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Ridesharing Service Example (CityLoop Mobility)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "MediatedExchange"
  ],
  "domain": "Transportation",
  "businessModel": [
    "Commission",
    "DynamicPricing",
    "Subscription"
  ],
  "deliveryFormat": [
    "MobileApp",
    "WebApp",
    "API"
  ],
  "name": {
    "en": "CityLoop Mobility",
    "es": "CityLoop Mobility",
    "fr": "CityLoop Mobility"
  },
  "description": {
    "en": "CityLoop Mobility is a fictional ridesharing platform mediating ride transactions between riders and verified drivers with real-time dispatch, route optimization, and safety escalation workflows.",
    "es": "CityLoop Mobility es una plataforma ficticia de ridesharing que media viajes entre pasajeros y conductores verificados con despacho en tiempo real y flujos de seguridad.",
    "fr": "CityLoop Mobility est une plateforme fictive de covoiturage a la demande qui medie les trajets entre passagers et conducteurs verifies avec dispatch temps reel et securite."
  },
  "shortDescription": {
    "en": "Ride-hailing marketplace with real-time dispatch, dynamic pricing, and trust-and-safety controls.",
    "es": "Marketplace de transporte con despacho en tiempo real, precio dinamico y controles de seguridad.",
    "fr": "Place de marche de transport avec dispatch temps reel, tarification dynamique et controles de surete."
  },
  "url": "https://cityloop-mobility.example",
  "foundingDate": "2019-07-04",
  "createdDate": "2026-02-20T20:32:00Z",
  "lastModified": "2026-02-20T20:32:00Z",
  "examples": [
    {
      "scenario": "Airport demand spike during holiday weekend",
      "note": "AI should prioritize mediated matching, surge pricing logic, and ETA reliability rather than modeling rides as direct fleet operations."
    },
    {
      "scenario": "Night safety escalation for delayed trip",
      "note": "AI should route through SOS, trip monitoring, and anomaly alert modules while preserving rider and driver role boundaries."
    }
  ],
  "properties": {
    "rideTypes": [
      "economy",
      "premium",
      "shared",
      "xl",
      "eco"
    ],
    "supportsScheduledRides": true,
    "supportsCarpooling": true,
    "surgePricingEnabled": true,
    "driverVerificationModel": "continuous_monitoring",
    "contactPoints": [
      {
        "contactType": "support",
        "telephone": "+1-415-555-0177",
        "email": "support@cityloop-mobility.example",
        "url": "https://cityloop-mobility.example/help",
        "areaServed": "US",
        "availableLanguages": [
          "en",
          "es"
        ]
      },
      {
        "contactType": "technical",
        "telephone": "+1-415-555-0122",
        "email": "safety@cityloop-mobility.example",
        "url": "https://cityloop-mobility.example/safety",
        "areaServed": "US",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "twitter",
        "url": "https://twitter.com/cityloopmobility",
        "username": "cityloopmobility"
      },
      {
        "platform": "instagram",
        "url": "https://instagram.com/cityloopmobility",
        "username": "cityloopmobility"
      },
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/cityloop-mobility",
        "username": "cityloop-mobility"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://cityloop-mobility.example"
      },
      {
        "type": "custom",
        "value": "RIDE-CLM-001"
      }
    ]
  },
  "capabilities": {
    "commerce": {
      "features": [
        "checkout",
        "orderTracking",
        "pricing",
        "search",
        "filtering",
        "listingManagement"
      ],
      "hasProductCatalog": false,
      "catalogSize": 0,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": true,
      "vendorManagement": true,
      "searchCapability": true,
      "filteringOptions": [
        "ride_type",
        "price",
        "eta",
        "accessibility"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "wallet",
        "billing",
        "subscriptionManagement",
        "escrow"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "digital_wallet",
        "bank_transfer"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD"
      ],
      "priceRange": "dynamic",
      "commissionModel": "percentage",
      "commissionRate": 18.5,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "interaction": {
      "features": [
        "messaging",
        "rating",
        "reviews",
        "notifications",
        "matching"
      ],
      "interactionMethods": [
        "in_app_messaging",
        "chat",
        "online_form"
      ],
      "availableActions": [
        "request_ride",
        "schedule_ride",
        "share_trip",
        "contact_driver",
        "report_issue"
      ],
      "hasMessaging": true,
      "hasComments": false,
      "hasRating": true,
      "hasReviews": true,
      "hasSocialGraph": false,
      "hasFeed": false,
      "hasNotifications": true,
      "hasMatching": true,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private",
        "semi_anonymous"
      ]
    },
    "location": {
      "features": [
        "geoCoordinates",
        "proximitySearch",
        "realTimeTracking",
        "routing"
      ],
      "hasPhysicalAddress": false,
      "hasGeoCoordinates": true,
      "hasMultipleLocations": true,
      "hasParking": false,
      "parkingType": "street",
      "isWheelchairAccessible": true,
      "publicTransitAccess": true,
      "deliveryZones": [
        "san_francisco",
        "oakland",
        "san_jose"
      ],
      "serviceRadius": 120
    },
    "community": {
      "features": [
        "groups",
        "communities",
        "discovery",
        "moderation",
        "membershipManagement"
      ],
      "supportsGroups": true,
      "supportsChannels": false,
      "communitiesCount": 66,
      "hasDiscovery": true,
      "hasModeration": true,
      "moderationModel": "human",
      "hasMembershipManagement": true,
      "membershipTypes": [
        "rider",
        "driver",
        "fleet_partner"
      ],
      "supportsGroupEvents": false,
      "supportsPolls": false,
      "hasGovernance": true,
      "governanceModel": "centralized",
      "privacyLevels": [
        "public",
        "closed"
      ]
    }
  },
  "modules": {
    "dispatch": {
      "autoMatchingEnabled": true,
      "etaPredictionEnabled": true,
      "demandRebalancingEnabled": true
    },
    "safety": {
      "sosFeatureEnabled": true,
      "tripMonitoringEnabled": true,
      "anomalyAlertsEnabled": true
    },
    "payments": {
      "instantDriverPayouts": true,
      "tipProcessingEnabled": true,
      "settlementCycleDays": 1
    },
    "tripData": {
      "tripDiscovery": {
        "canonicalTripStatusUrl": "https://cityloop-mobility.example/trip-status",
        "dataSources": [
          {
            "sourceType": "public_api_endpoint",
            "sourceUrl": "https://cityloop-mobility.example/public/trip-policies.json",
            "format": "json",
            "updateCadence": "daily"
          }
        ]
      }
    }
  },
  "structuralMetadata": {
    "topology": "triadic",
    "roles": [
      "buyer",
      "seller",
      "platform"
    ],
    "valueSource": "transaction_mediation",
    "transactionFlow": "escrow",
    "networkEffects": "cross_side",
    "matchingMechanism": "hybrid"
  },
  "targetAudience": [
    "commuters",
    "airport_travelers",
    "night_shift_workers",
    "drivers"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "text_scaling",
      "high_contrast_mode"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T20:32:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "RidesharingService is modeled as DigitalEntity plus MediatedExchange because rider-driver matching and transaction mediation are the core value mechanics.",
    "disambiguationNotes": "This model is not a direct taxi fleet service schema. It represents multi-party matching, trip mediation, and platform-governed payouts.",
    "intendedUse": "Canonical filled reference for ridesharing platforms publishing static AI-readable architecture metadata."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-RSGF-001: @type MUST equal \"RidesharingService\"",
      "RULE-RSGF-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-RSGF-003: interactionArchetype MUST contain exactly one value: \"MediatedExchange\"",
      "RULE-RSGF-004: capabilities MUST include commerce, financial, and interaction groups",
      "RULE-RSGF-005: modules.dispatch, modules.safety, and modules.payments MUST be present",
      "RULE-RSGF-006: structuralMetadata constants MUST align with MediatedExchange archetype",
      "RULE-RSGF-007: examples MUST include at least two operational scenarios",
      "RULE-RSGF-008: schema MUST NOT expose credential or secret fields"
    ]
  }
}
