# Ride with GPS

> Browse, copy and update cycling routes, inspect rides and events, and watch changes to your library.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/ride-with-gps

## Actions

### Copy route to a route

Create a private copy in your routes unless you choose another visibility.

**Inputs**

- Route (`route_id`, number, required): Select a route or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.
- Name (`name`, text): Name for the new route.
- Visibility (`visibility`, text): Who can see the new route. One of: `public`, `followers_only` (Followers only), `mutual_followers_only` (Mutual followers only), `private`.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "route": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Delete route

Permanently delete a route you own.

**Inputs**

- Route (`route_id`, number, required): Select a route or enter its ID.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {}
}
```

### Download route

Download the route file as base64.

**Inputs**

- Route (`route_id`, number, required): Select a route or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.
- File format (`file_format`, text, required): Format of the downloaded GPS file. One of: `gpx`, `tcx`, `fit`, `kml`.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "content_base64": "example",
    "content_type": "example"
  }
}
```

### Download trip

Download the trip file as base64.

**Inputs**

- Trip (`trip_id`, number, required): Select a trip or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.
- File format (`file_format`, text, required): Format of the downloaded GPS file. One of: `gpx`, `tcx`, `fit`, `kml`.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "content_base64": "example",
    "content_type": "example"
  }
}
```

### Get collection

Read the items and metadata for a collection.

**Inputs**

- Collection (`collection_id`, number, required): Select a collection or enter its ID.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "collection": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Get current rider

Read the account associated with your token.

**Inputs**: None.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "user": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Get event

Read a cycling event and its routes.

**Inputs**

- Event (`event_id`, number, required): Select a event or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "event": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Get my event RSVP

Read your RSVP for an event.

**Inputs**

- Event (`event_id`, number, required): Select a event or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "participant": {}
  }
}
```

### Get pinned collection

Read the routes and trips pinned to your account.

**Inputs**: None.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "collection": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Get route

Read the complete route, including its track.

**Inputs**

- Route (`route_id`, number, required): Select a route or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "route": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Get route polyline

Read the simplified track as a Google encoded polyline.

**Inputs**

- Route (`route_id`, number, required): Select a route or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "polyline": {
      "data": "example",
      "parent_id": 1,
      "parent_type": "example"
    }
  }
}
```

### Get trip

Read the complete trip, including its track.

**Inputs**

- Trip (`trip_id`, number, required): Select a trip or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "trip": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Get trip polyline

Read the simplified track as a Google encoded polyline.

**Inputs**

- Trip (`trip_id`, number, required): Select a trip or enter its ID.
- Privacy code (`privacy_code`, text): Privacy code from the shared link, when required.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "polyline": {
      "data": "example",
      "parent_id": 1,
      "parent_type": "example"
    }
  }
}
```

### List collections

List a page of route and trip collections.

**Inputs**

- Page (`page`, number): Page of results. At least 1.
- Page size (`page_size`, number): Results per page. From 20 to 200.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "collections": [
      {
        "id": 1,
        "name": "example"
      }
    ],
    "meta": {}
  }
}
```

### List events

List a page of events you can access.

**Inputs**

- Page (`page`, number): Page of results. At least 1.
- Page size (`page_size`, number): Results per page. From 20 to 200.
- Name (`name`, text): Find records whose name contains this text.
- Visibility (`visibility`, text): Filter by who can see the event. One of: `public`, `followers_only` (Followers only), `mutual_followers_only` (Mutual followers only), `private`.
- Archived (`archived`, true/false): Return archived events.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "events": [
      {
        "id": 1,
        "name": "example"
      }
    ],
    "meta": {}
  }
}
```

### List library changes

List route and trip changes since a date and time.

**Inputs**

- Since (`since`, date and time, required): Start of the sync window.
- Assets (`assets`, list): Kinds of records to sync. One or more of: `routes`, `trips`.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "items": [
      {
        "action": "example",
        "datetime": "example",
        "item_id": 1,
        "item_type": "example",
        "item_url": "example",
        "item_user_id": 1
      }
    ],
    "meta": {
      "next_sync_url": "example",
      "rwgps_datetime": "example"
    }
  }
}
```

### List routes

Read a page of your routes.

**Inputs**

- Page (`page`, number): Page of results. At least 1.
- Page size (`page_size`, number): Results per page. From 20 to 200.
- Name (`name`, text): Find records whose name contains this text.
- Visibility (`visibility`, text): Filter by visibility. One of: `public`, `followers_only` (Followers only), `mutual_followers_only` (Mutual followers only), `private`.
- Distance min (`distance_min`, number): Minimum distance in meters. At least 0.
- Distance max (`distance_max`, number): Maximum distance in meters. At least 0.
- Archived (`archived`, true/false): Filter by archived status.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "meta": {},
    "routes": [
      {
        "id": 1,
        "name": "example"
      }
    ]
  }
}
```

### List trips

Read a page of your trips.

**Inputs**

- Page (`page`, number): Page of results. At least 1.
- Page size (`page_size`, number): Results per page. From 20 to 200.
- Name (`name`, text): Find records whose name contains this text.
- Visibility (`visibility`, text): Filter by visibility. One of: `public`, `followers_only` (Followers only), `mutual_followers_only` (Mutual followers only), `private`.
- Distance min (`distance_min`, number): Minimum distance in meters. At least 0.
- Distance max (`distance_max`, number): Maximum distance in meters. At least 0.
- Stationary (`stationary`, true/false): Filter by whether the ride was stationary.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "meta": {},
    "trips": [
      {
        "id": 1,
        "name": "example"
      }
    ]
  }
}
```

### Update route

Change details and keep fields you leave blank.

**Inputs**

- Route (`route_id`, number, required): Select a route or enter its ID.
- Name (`name`, text): New route name.
- Description (`description`, text): New route description.
- Visibility (`visibility`, text): Who can see it. One of: `public`, `followers_only` (Followers only), `mutual_followers_only` (Mutual followers only), `private`.
- Activity types (`activity_types`, list): Replace the activity types with the selected values. One or more of: `cycling:generic`, `cycling:road`, `cycling:gravel`, `cycling:mountain`, `cycling:commute`, `walking:generic`, `walking:hiking`, `running:generic`, `driving:generic`, `motorcycling:generic`, `swimming:generic`, `snow:generic`.
- Archived (`archived`, true/false): Move the route into or out of the archive.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "route": {
      "id": 1,
      "name": "example"
    }
  }
}
```

### Update trip

Change details and keep fields you leave blank.

**Inputs**

- Trip (`trip_id`, number, required): Select a trip or enter its ID.
- Name (`name`, text): New trip name.
- Description (`description`, text): New trip description.
- Visibility (`visibility`, text): Who can see it. One of: `public`, `followers_only` (Followers only), `mutual_followers_only` (Mutual followers only), `private`.
- Activity type (`activity_type`, text): Activity for this ride. One of: `other:generic`, `cycling:generic`, `cycling:road`, `cycling:gravel`, `cycling:cyclocross`, `cycling:mountain`, `cycling:recumbent`, `cycling:hand_cycling` (Cycling:hand cycling), `cycling:commute`, `cycling:indoor`, and 30 more.

**Outputs**

- `data` (object): The response from Ride with GPS.

**Example output**

```json
{
  "data": {
    "trip": {
      "id": 1,
      "name": "example"
    }
  }
}
```
