NYC Modern Taxi Co - Operations 0.0.1

Operations

Messages

NYC Modern Taxi Co - Operations 0.0.1

Terms of Service

This is a simulated event feed for the fictional "Modern NYC Taxi Co" for the purposes of learning. The event feed simulates taxis streaming real-time events that include ride and location information.

  • The dataset used originally comes from the NYC Taxi & Limousine Commission's open data release of more than a billion taxi ride records. Google then extended one week worth of data (3M taxi rides) from their original pickup and drop-off points into full routes in order to simulate a fleet of taxis roaming the streets of NYC as they define here. Solace is streaming this data over Solace PubSub+ for you to analyze and process.

  • Terms of Use: This dataset is publicly available for anyone to use under the following terms provided by the Dataset Source — https://data.cityofnewyork.us/ — and is provided "AS IS" without any warranty, express or implied, from Solace. Solace disclaims all liability for any damages, direct or indirect, resulting from the use of the dataset.

Contact link: Solace Community Contact email: community@solace.com

Servers

tcp://taxi.messaging.solace.cloud:55555 smf

Connect using SMF.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
msg_vpn:
DEFAULT: nyc-modern-taxi
Security:
  • User / Password:

    Connect using Solace Basic Authentication
tcps://taxi.messaging.solace.cloud:55443 smf

Connect using Secured SMF.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
msg_vpn:
DEFAULT: nyc-modern-taxi
Security:
  • User / Password:

    Connect using Solace Basic Authentication
wss://taxi.messaging.solace.cloud:443 wss

Connect using SMF with Secured Solace Web Messaging.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
msg_vpn:
DEFAULT: nyc-modern-taxi
Security:
  • User / Password:

    Connect using Solace Basic Authentication
ssl://taxi.messaging.solace.cloud:8883 mqtt

Connect using secured MQTT.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
Security:
  • User / Password:

    Connect using Solace Basic Authentication
wss://taxi.messaging.solace.cloud:8443 wss

Connect using secured MQTT over Websockets.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
Security:
  • User / Password:

    Connect using Solace Basic Authentication
https://taxi.messaging.solace.cloud:9443 https

Connect using Solace REST Messaging.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
Security:
  • User / Password:

    Connect using Solace Basic Authentication
amqps://taxi.messaging.solace.cloud:5671 amqps

Connect using Secured AMQP.

username:
DEFAULT: public-taxi-user
password:
DEFAULT: iliketaxis
Security:
  • User / Password:

    Connect using Solace Basic Authentication

Operations

Sub taxinyc/ops/ride/updated/v1/{ride_status}/{driver_id}/{passenger_id}/{current_latitude}/{current_longitude}

This dynamic channel is used for apps to send/receive RideUpdated events

Parameters
ride_status #/properties/ride_status
required
string

The current status of the ride.

Default: ""
Enum: "accepted" "pickup" "enroute" "dropoff"
Examples: "enroute"
driver_id #/properties/driver/properties/driver_id
required
integer

A unique ID for the driver.

Default: 0
Examples: 1234132
passenger_id #/properties/passenger/properties/passenger_id
required
integer

A unique ID for the passenger.

Default: 0
Examples: 2345243
current_latitude #/properties/latitude
required
number
>= -90 <= 90

Current latitude of the vehicle.

Default: 0
Examples: -40.75473
current_longitude #/properties/longitude
required
number
>= -180 <= 180

Current longitude of the vehicle.

Default: 0
Examples: -123.98385

Accepts the following message:

RideUpdated

Payload http://example.com/example.json
object

A RideUpdated Event represents the latest state of an individual taxi ride.

Default: {}
Examples: { "ride_id": "545496c5-a334-4344-9662-efde68c0b98a", "heading": 111, "latitude": 40.75473, "passenger_count": 1, "point_idx": 107, "information_source": "RideDispatcher", "speed": 8, "driver": { "driver_id": 1234132, "rating": 4.75, "last_name": "Smith", "car_class": "SUV", "first_name": "Frank" }, "passenger": { "passenger_id": 2345243, "rating": 2.23, "last_name": "Menning", "first_name": "Tamimi" }, "meter_increment": 0.02278058, "longitude": -73.98385, "timestamp": "2020-06-03T16:51:47.292-04:00", "meter_reading": 2.4375222, "ride_status": "enroute" }
ride_id #/properties/ride_id
string

A UUID identifying the ride.

Default: ""
Examples: "545496c5-a334-4344-9662-efde68c0b98a"
heading #/properties/heading
integer
>= 0 <= 359

0-359 degrees approximate heading of the vehicle.

Default: 0
Examples: 111
latitude #/properties/latitude
number
>= -90 <= 90

Current latitude of the vehicle.

Default: 0
Examples: -40.75473
passenger_count #/properties/passenger_count
integer
>= 0

The number of passengers in the car during this ride.

Default: 0
Examples: 1
point_idx #/properties/point_idx
integer

The update number for the ride. This increments for each RideUpdate for a given ride.

Default: 0
Examples: 107
information_source #/properties/information_source
string

The app that sent this event.

Default: ""
Examples: "RideDispatcher"
speed #/properties/speed
integer
>= 0

Speed of the taxi in unknown units.

Default: 0
Examples: 20
driver #/properties/driver
object

Information about the driver.

Default: {}
Examples: { "driver_id": 1234132, "rating": 4.73, "last_name": "Smith", "car_class": "SUV", "first_name": "Frank" }
driver_id #/properties/driver/properties/driver_id
required
integer

A unique ID for the driver.

Default: 0
Examples: 1234132
rating #/properties/driver/properties/rating
required
number
>= 0 <= 5

The driver's current 5-star rating, showing 2 decimal places of accuracy.

Default: 0
Examples: 4.32
last_name #/properties/driver/properties/last_name
required
string

The Driver's Last Name.

Default: ""
Examples: "Smith"
car_class #/properties/driver/properties/car_class
required
string

The class of the vehicle.

Default: ""
Examples: "SUV" "Minivan" "Sedan" "Coupe"
first_name #/properties/driver/properties/first_name
required
string

The Driver's first name.

Default: ""
Examples: "Frank"

Additional properties are allowed.

passenger #/properties/passenger
object

Information about the Passenger.

Default: {}
Examples: { "rating": 2.25, "last_name": "Menning", "passenger_id": 2345243, "first_name": "Tamimi" }
rating #/properties/passenger/properties/rating
required
number
>= 0 <= 5

The passenger's current 5-star rating, showing 2 decimal places of accuracy.

Default: 0
Examples: 2.25
last_name #/properties/passenger/properties/last_name
required
string

The passenger's last name.

Default: ""
Examples: "Menning"
passenger_id #/properties/passenger/properties/passenger_id
required
integer

A unique ID for the passenger.

Default: 0
Examples: 2345243
first_name #/properties/passenger/properties/first_name
required
string

The passenger's first name.

Default: ""
Examples: "Jesse"

Additional properties are allowed.

meter_increment #/properties/meter_increment
number

The meter increment rate.

Default: 0
Examples: 0.02278058
longitude #/properties/longitude
number
>= -180 <= 180

Current longitude of the vehicle.

Default: 0
Examples: -123.98385
timestamp #/properties/timestamp
string

The time the RideUpdate is being sent.

Default: ""
Examples: "2020-06-03T16:51:47.292-04:00"
meter_reading #/properties/meter_reading
number
>= 0

The current value of the taxi's meter, in dollars $. Float value will always be shown with 2 decimal places (cents).

Default: 0
Examples: 2.42
ride_status #/properties/ride_status
string

The current status of the ride.

Default: ""
Enum: "accepted" "pickup" "enroute" "dropoff"
Examples: "enroute"

Additional properties are allowed.

Examples

RideUpdated
Payload
Example #1
{
  "ride_id": "545496c5-a334-4344-9662-efde68c0b98a",
  "heading": 111,
  "latitude": 40.75473,
  "passenger_count": 1,
  "point_idx": 107,
  "information_source": "RideDispatcher",
  "speed": 8,
  "driver": {
    "driver_id": 1234132,
    "rating": 4.75,
    "last_name": "Smith",
    "car_class": "SUV",
    "first_name": "Frank"
  },
  "passenger": {
    "passenger_id": 2345243,
    "rating": 2.23,
    "last_name": "Menning",
    "first_name": "Tamimi"
  },
  "meter_increment": 0.02278058,
  "longitude": -73.98385,
  "timestamp": "2020-06-03T16:51:47.292-04:00",
  "meter_reading": 2.4375222,
  "ride_status": "enroute"
}

Messages

#1 RideUpdated

Payload http://example.com/example.json
object

A RideUpdated Event represents the latest state of an individual taxi ride.

Default: {}
Examples: { "ride_id": "545496c5-a334-4344-9662-efde68c0b98a", "heading": 111, "latitude": 40.75473, "passenger_count": 1, "point_idx": 107, "information_source": "RideDispatcher", "speed": 8, "driver": { "driver_id": 1234132, "rating": 4.75, "last_name": "Smith", "car_class": "SUV", "first_name": "Frank" }, "passenger": { "passenger_id": 2345243, "rating": 2.23, "last_name": "Menning", "first_name": "Tamimi" }, "meter_increment": 0.02278058, "longitude": -73.98385, "timestamp": "2020-06-03T16:51:47.292-04:00", "meter_reading": 2.4375222, "ride_status": "enroute" }
ride_id #/properties/ride_id
string

A UUID identifying the ride.

Default: ""
Examples: "545496c5-a334-4344-9662-efde68c0b98a"
heading #/properties/heading
integer
>= 0 <= 359

0-359 degrees approximate heading of the vehicle.

Default: 0
Examples: 111
latitude #/properties/latitude
number
>= -90 <= 90

Current latitude of the vehicle.

Default: 0
Examples: -40.75473
passenger_count #/properties/passenger_count
integer
>= 0

The number of passengers in the car during this ride.

Default: 0
Examples: 1
point_idx #/properties/point_idx
integer

The update number for the ride. This increments for each RideUpdate for a given ride.

Default: 0
Examples: 107
information_source #/properties/information_source
string

The app that sent this event.

Default: ""
Examples: "RideDispatcher"
speed #/properties/speed
integer
>= 0

Speed of the taxi in unknown units.

Default: 0
Examples: 20
driver #/properties/driver
object

Information about the driver.

Default: {}
Examples: { "driver_id": 1234132, "rating": 4.73, "last_name": "Smith", "car_class": "SUV", "first_name": "Frank" }
driver_id #/properties/driver/properties/driver_id
required
integer

A unique ID for the driver.

Default: 0
Examples: 1234132
rating #/properties/driver/properties/rating
required
number
>= 0 <= 5

The driver's current 5-star rating, showing 2 decimal places of accuracy.

Default: 0
Examples: 4.32
last_name #/properties/driver/properties/last_name
required
string

The Driver's Last Name.

Default: ""
Examples: "Smith"
car_class #/properties/driver/properties/car_class
required
string

The class of the vehicle.

Default: ""
Examples: "SUV" "Minivan" "Sedan" "Coupe"
first_name #/properties/driver/properties/first_name
required
string

The Driver's first name.

Default: ""
Examples: "Frank"

Additional properties are allowed.

passenger #/properties/passenger
object

Information about the Passenger.

Default: {}
Examples: { "rating": 2.25, "last_name": "Menning", "passenger_id": 2345243, "first_name": "Tamimi" }
rating #/properties/passenger/properties/rating
required
number
>= 0 <= 5

The passenger's current 5-star rating, showing 2 decimal places of accuracy.

Default: 0
Examples: 2.25
last_name #/properties/passenger/properties/last_name
required
string

The passenger's last name.

Default: ""
Examples: "Menning"
passenger_id #/properties/passenger/properties/passenger_id
required
integer

A unique ID for the passenger.

Default: 0
Examples: 2345243
first_name #/properties/passenger/properties/first_name
required
string

The passenger's first name.

Default: ""
Examples: "Jesse"

Additional properties are allowed.

meter_increment #/properties/meter_increment
number

The meter increment rate.

Default: 0
Examples: 0.02278058
longitude #/properties/longitude
number
>= -180 <= 180

Current longitude of the vehicle.

Default: 0
Examples: -123.98385
timestamp #/properties/timestamp
string

The time the RideUpdate is being sent.

Default: ""
Examples: "2020-06-03T16:51:47.292-04:00"
meter_reading #/properties/meter_reading
number
>= 0

The current value of the taxi's meter, in dollars $. Float value will always be shown with 2 decimal places (cents).

Default: 0
Examples: 2.42
ride_status #/properties/ride_status
string

The current status of the ride.

Default: ""
Enum: "accepted" "pickup" "enroute" "dropoff"
Examples: "enroute"

Additional properties are allowed.