Kwolo.MaseratiConnect 1.0.0

There is a newer prerelease version of this package available.
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                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Kwolo.MaseratiConnect" Version="1.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Kwolo.MaseratiConnect --version 1.0.0                
#r "nuget: Kwolo.MaseratiConnect, 1.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.2-alpha is deprecated.
1.0.1-alpha 141 11/23/2023 1.0.1-alpha is deprecated.
1.0.0 274 11/21/2023