# Python wrapper for the ConnectedCars REST API
Connected Cars is an AVL/data collection service installed in most new **danish** vehicles from Audi, Volkswagen, Skoda and SEAT. The service has an API that is using *GraphQL*. This is a thin python wrapper for that API which handles authentication and refresh of access tokens. It allows the direct execution of *GraphQL* queries, but also includes some predefined queries that returns pyton objects for convenience.
## Installation
```pip install connectedcars```
## Data available
Depends on the car, but examples includes:
- gps position
- fuel level
- odometer
## Usage
```python
from connectedcars import ConnectedCarsClient
client = ConnectedCarsClient(username = 'XXX', password = 'XXX', namespace = 'XXX')
vehicles = client.vehicles_overview()
for vehicle in vehicles:
print(vehicle.make, vehicle.model, vehicle.fuelLevel.liter)
```
Could output something like:
```
Volkswagen Golf 38.0
```
## Namespaces
You will need to provide a namespace corresponding to your login. Known namespaces are:
- `semler:minvolkswagen`
Raw data
{
"_id": null,
"home_page": "https://github.com/niklascp/connectedcars-python",
"name": "connectedcars",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "AVL,Audi,Volkswagen,Skoda,SEAT",
"author": "Niklas Christoffer Petersen",
"author_email": "nikalscp@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ec/67/94049055e5ad628c49eb8afe7242371372fb700ab5d3b35dd913f6ec6cc8/connectedcars-0.1.5.tar.gz",
"platform": "",
"description": "# Python wrapper for the ConnectedCars REST API \n\nConnected Cars is an AVL/data collection service installed in most new **danish** vehicles from Audi, Volkswagen, Skoda and SEAT. The service has an API that is using *GraphQL*. This is a thin python wrapper for that API which handles authentication and refresh of access tokens. It allows the direct execution of *GraphQL* queries, but also includes some predefined queries that returns pyton objects for convenience.\n\n## Installation\n\n```pip install connectedcars```\n\n## Data available\n\nDepends on the car, but examples includes:\n\n- gps position\n- fuel level\n- odometer\n\n## Usage\n```python\nfrom connectedcars import ConnectedCarsClient\n\nclient = ConnectedCarsClient(username = 'XXX', password = 'XXX', namespace = 'XXX')\nvehicles = client.vehicles_overview()\n\nfor vehicle in vehicles:\n print(vehicle.make, vehicle.model, vehicle.fuelLevel.liter)\n```\n\nCould output something like:\n```\nVolkswagen Golf 38.0\n```\n\n## Namespaces\nYou will need to provide a namespace corresponding to your login. Known namespaces are:\n\n- `semler:minvolkswagen`\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Wrapper for access the Connected Cars API - an AVL/data collection service installed in most new danish vehicles from Audi, Volkswagen, Skoda and SEAT.",
"version": "0.1.5",
"split_keywords": [
"avl",
"audi",
"volkswagen",
"skoda",
"seat"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "6be935101bc631172bc2b8936a8dccac",
"sha256": "9311c8d9da718d4226f2e63834f9b82897f57ad78e3d48b1fc7b350a9b30ec16"
},
"downloads": -1,
"filename": "connectedcars-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6be935101bc631172bc2b8936a8dccac",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6346,
"upload_time": "2021-03-09T16:32:16",
"upload_time_iso_8601": "2021-03-09T16:32:16.171630Z",
"url": "https://files.pythonhosted.org/packages/e7/38/20b9c6e05c6a2974f585da58bb16ad4e243231eccc257271ad0f83419702/connectedcars-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "a8749581ef3bbb2f9706726367243a8a",
"sha256": "2fb12cb5ffb9e4cfe43a4ae3cd121dd8fe75272fd224a09c2c653945ff20a57e"
},
"downloads": -1,
"filename": "connectedcars-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "a8749581ef3bbb2f9706726367243a8a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4666,
"upload_time": "2021-03-09T16:32:17",
"upload_time_iso_8601": "2021-03-09T16:32:17.469505Z",
"url": "https://files.pythonhosted.org/packages/ec/67/94049055e5ad628c49eb8afe7242371372fb700ab5d3b35dd913f6ec6cc8/connectedcars-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2021-03-09 16:32:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": null,
"github_project": "niklascp",
"error": "Could not fetch GitHub repository",
"lcname": "connectedcars"
}