https://github.com/ptv-logistics/clients-route-optimization-optiflow-api
Clients for the route optimization optiflow api
https://github.com/ptv-logistics/clients-route-optimization-optiflow-api
clients delivery last-mile logistics pickup-and-delivery ptv-developer solver traveling-salesman-problem tsp tsp-solver vehicle-routing-problem vrp vrp-sol
Last synced: 3 months ago
JSON representation
Clients for the route optimization optiflow api
- Host: GitHub
- URL: https://github.com/ptv-logistics/clients-route-optimization-optiflow-api
- Owner: ptv-logistics
- License: apache-2.0
- Created: 2024-01-08T09:36:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-03T08:07:22.000Z (4 months ago)
- Last Synced: 2025-06-05T09:08:54.271Z (4 months ago)
- Topics: clients, delivery, last-mile, logistics, pickup-and-delivery, ptv-developer, solver, traveling-salesman-problem, tsp, tsp-solver, vehicle-routing-problem, vrp, vrp-sol
- Language: C#
- Homepage:
- Size: 646 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Clients for the Route Optimization OptiFlow API
Using client classes makes it easier and more convenient to integrate the API into an existing programming environment. We provide here clients for Java, C# and TypeScript. Alternatively you can generate the clients yourself by using this [tutorial](https://developer.myptv.com/en/resources/tutorials/general/how-generate-clients-ptv-developer-apis).
Language depending information:
* **DotNet:** Please add the following nuget packages to your client project
* Please use .NET 8.0
* JsonSubTypes (1.8.0)
* Polly (7.2.3)
* RestSharp (106.13.0)
* System.ComponentModel.Annotations (5.0.0)
To initialize your client with your APIKey you can use the following snippet:
```
var apiKey = new Dictionary(){["apiKey"] = "Enter your ApiKey here" };
var configuration = new Configuration() { ApiKey = apiKey };
PlansApi plansApi = new PlansApi(configuration);
```
If your APIKey allows for at least 5000 Orders, before you start a big Optimization in class OptimizationAPI, you may have to compress your payload. For this
* set ``` localVarRequestOptions.HeaderParameters.Add("Content-Encoding", "gzip"); ```
* use compressed data as body of your http request
```
MemoryStream memStream1 = new MemoryStream();
BinaryFormatter binFormatter = new BinaryFormatter();
binFormatter.Serialize(memStream1, optimizationRequest);
byte[] data = memStream1.ToArray();
MemoryStream memStream2 = new MemoryStream();
GZipStream gzStream = new GZipStream(memStream2, CompressionMode.Compress);
gzStream.Write(data, 0, data.Length);
localVarRequestOptions.Data = memStream2.ToArray();
```
* **Java:** Please add the following dependencies to your project
```
com.fasterxml.jackson.core
jackson-core
2.18.3
com.fasterxml.jackson.core
jackson-annotations
2.18.3
com.fasterxml.jackson.core
jackson-databind
2.18.3
com.fasterxml.jackson.datatype
jackson-datatype-jsr310
2.18.3
org.openapitools
jackson-databind-nullable
0.2.6
com.github.ptv-logistics
openapi-generator-cli
7.5.0
jakarta.ws.rs
jakarta.ws.rs-api
4.0.0
```
To initialize your client with your APIKey you can use the following snippet:
```
ApiClient apiClient = Configuration.getDefaultApiClient()
.setRequestInterceptor(builder -> builder.setHeader("ApiKey", "Enter your ApiKey here"));
PlansApi plansApi = new PlansApi(apiClient);
```
If your APIKey allows for at least 5000 Orders, before you start a big Optimization in class OptimizationAPI, you may have to compress your payload. For this
* set ``` localVarRequestBuilder.header("Content-Encoding", "gzip"); ```
* use compressed data as body of your http request
```
byte[] localVarPostBody = memberVarObjectMapper.writeValueAsBytes(optimizationRequest);
String requested = new String(localVarPostBody, StandardCharsets.UTF_8);
ByteArrayOutputStream baOutStream = new ByteArrayOutputStream();
GZIPOutputStream gzipOutStream = new GZIPOutputStream(baOutStream);
gzipOutStream.write(localVarPostBody, 0, localVarPostBody.length);
gzipOutStream.close();
byte[] localVarPostBody_1 = baOutStream.toByteArray();
```
* **TypeScript:** Please add the following dependecies to your project
* aurelia-api (3.2.1)
* aurelia-fetch-client (1.8.2)
* node-fetch (2.6.1)
* polly-js (1.8.0)
* typescript (4.1.2)
* @types/node (18.11.18)
* typescript-http-client (0.10.1)
To initialize your client with your APIKey you can use the following snippet:
```
let configurationParameters: ConfigurationParameters = {fetchApi: require('node-fetch'),
headers: {ApiKey: "Enter your ApiKey here"}};
let configuration: Configuration = new Configuration(configurationParameters);
let plansApi: PlansApi = new PlansApi(configuration);
```
If your APIKey allows for at least 5000 Orders, before you start a big Optimization in class OptimizationAPI, you may have to compress your payload. For this
* set ``` headerParameters['Content-Encoding'] = 'gzip'; ```
* use compressed data as body of your http request
```
const jsonString = JSON.stringify(requestParameters.optimizationRequest);
const data = new TextEncoder().encode(jsonString);
const compressedData = await gzipModule.compress(data);
```
Please refer to our [Route Optimization Optiflow API](https://developer.myptv.com/en/documentation/route-optimization-optiflow-api-experimental/quick-start-route-optimization-optiflow) documentation.