Kwolo.MaseratiConnect
1.0.0
See the version list below for details.
dotnet add package Kwolo.MaseratiConnect --version 1.0.0
NuGet\Install-Package Kwolo.MaseratiConnect -Version 1.0.0
<PackageReference Include="Kwolo.MaseratiConnect" Version="1.0.0" />
paket add Kwolo.MaseratiConnect --version 1.0.0
#r "nuget: Kwolo.MaseratiConnect, 1.0.0"
// Install Kwolo.MaseratiConnect as a Cake Addin #addin nuget:?package=Kwolo.MaseratiConnect&version=1.0.0 // Install Kwolo.MaseratiConnect as a Cake Tool #tool nuget:?package=Kwolo.MaseratiConnect&version=1.0.0
Maserati Connect
Project URL
https://gitlab.com/skotl/maseraticonnect
Background
This class library allows you to connect to the Maserati Connect web site and retrieve details of your vehicle.
As it seems that the Fiat group have done a decent job of protecting the web APIs I haven't been able to create a 100% API-driven solution. Instead, this project uses the Selenium WebDriver to log on to the Maserati Connect home page and, once logged on, it listens for a request to the API and captures the response (more details below).
This class library returns a Car
object that contains the following
details (if available - not all of them are, and some seem to
temporarily go awol...):
- Vehicle Identification Number ("VIN")
- Last vehicle update time
- Wheel count (you never know when this might be handy!)
- Distance to next service
- Days to next service
- Is service due flag
- Odometer reading (in miles)
- Tyre pressures
- List of service items that need attention
Nuget package details
This library is available as a Nuget package at https://todo....
Usage
There is a sample application - Kwolo.MaseratiConnect.TestHarness
that shows how to use the library. It is easiest to get this
working in an application that already has a hosted service
/ dependency injection set up. Assuming you do then start
with:
using Kwolo.MaseratiConnect;
// ...
var builder = Host.CreateApplicationBuilder(args);
// or other host builder
// ... other services configuration
// Add Maserati Connect services into the collection
builder.Services.UseMaseratiConnect();
To call into the service you need to construct a
ConnectionDetails
and populate it as:
class ConnectionDetails{
public string LoginUrl { get; set; }
public string DashboardUrl { get; set; }
public string UserLogin { get; set; }
public string UserPassword { get; set; }
public bool ShowChromiumWindow { get; set; }
}
Property | Description |
---|---|
LoginUrl | The URL of your Maserati connect login page. Start at https://connect.maserati.com and navigate through until you get the URL for your country's login.<br/> Use that value here. |
DashboardUrl | Once you have the Login URL, get logged in and find the view that shows you the dashboard (where your fuel level, tyre pressure etc. is displayed).<br />Use that URL here. |
UserLogin | Your Maserati Connect login, probably your email |
UserPassword | Your password |
ShowChromiumWindow | Defaults to false, showing no Chromium window. Set true to help debugging. |
Examples of URLs for the UK would be:
LoginUrl="https://connect.maserati.com/gb/en/login"
DashboardUrl="https://connect.maserati.com/gb/en/vehicle-services"
Note the "/gb/en"
for UK/Great Britain in English. Don't
try to guess the correct settings for your region - login
and find the appropriate URLs with your own credentials.
Once you have these values, plug them into your ConnectionDetails
object and pass that to the MaseratiConnector.FetchData()
method:
var car = _maseratiConnector.FetchData(options);
The resultant Car
object should contain the data
scraped from the website.
How it works
Although the class library requires screen scraping to get logged in and handle the authentication workflow with the AWS services behind the scenes, it does not use screen scraping to get data.
Instead, it sets up a network response listener inside
the Selenium driver and waits for a specific network
API call to an endpoint that ends in "/vhr"
- you
can see this in action in your web browser if you turn
on developer tools and navigate to the Network tab.
Helpfully, the request to this endpoint returns data
in a JSON structure, so we just need to hoover that
up into the DTOs and then convert them into
the Car
object and its strongly-typed children.
Building, tests and enhancements
The class library is currently built against .net 8 with C# 12. Tests are in place for the type and value converters.
Enhancements and PRs are welcome.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- Selenium.WebDriver (>= 4.15.0)
- Selenium.WebDriver.NetCoreWebDriverFactory (>= 4.1.0)
- SeleniumExtras.WaitHelpers (>= 1.0.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
1.0.2-alpha | 235 | 11/23/2023 | |
1.0.1-alpha | 141 | 11/23/2023 | |
1.0.0 | 274 | 11/21/2023 |