כדי ליהנות מחוויית פיתוח טובה יותר מאשר פיתוח באמצעות REST או gRPC גולמיים לתקשורת בין שרתים, מומלץ להשתמש בספריות הלקוח הספציפיות לשפה של Google. אפשר למצוא את קובצי ה-protobuf שעליהם מבוססים הלקוחות האלה במאגר GitHub.
אם ספריות לא קיימות בשפת האפליקציה שלכם, צריך להשתמש ב-gRPC או בנקודות הקצה Fleet Engine REST.
הערה: ספריות הלקוח של Google Cloud מיועדות לפעול בסביבות שרת מהימנות. אין צורך ב-JWT. משתמשים ב-Application Default Credentials עם התפקיד המתאים deliveryAdmin
.
Java
ספריות Java מתפרסמות בקטע google.maps.fleetengine.delivery.v1
.
Gradle
plugins {
id "maven-publish"
id "com.google.cloud.artifactregistry.gradle-plugin" version "2.1.4"
}
publishing {
repositories {
maven {
url "artifactregistry://us-maven.pkg.dev/fleetengine-gapic/maven"
}
}
}
repositories {
maven {
url "artifactregistry://us-maven.pkg.dev/fleetengine-gapic/maven"
}
}
dependencies {
implementation 'com.google.maps:gapic-google-maps-fleetengine-delivery-v1-java:latest.release'
}
Maven
<project>
<distributionManagement>
<snapshotRepository>
<id>artifact-registry</id>
<url>artifactregistry://us-maven.pkg.dev/fleetengine-gapic/maven</url>
</snapshotRepository>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-maven.pkg.dev/fleetengine-gapic/maven</url>
</repository>
</distributionManagement>
<repositories>
<repository>
<id>artifact-registry</id>
<url>artifactregistry://us-maven.pkg.dev/fleetengine-gapic/maven</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<build>
<extensions>
<extension>
<groupId>com.google.cloud.artifactregistry</groupId>
<artifactId>artifactregistry-maven-wagon</artifactId>
<version>2.1.4</version>
</extension>
</extensions>
</build>
<dependency>
<groupId>com.google.maps</groupId>
<artifactId>gapic-google-maps-fleetengine-delivery-v1-java</artifactId>
<version>LATEST</version>
</dependency>
</project>
תוכלו לראות דוגמאות של Java לאינטראקציה עם Fleet Engine API בדף Get a delivery vehicle.
ספריית אימות של Fleet Engine
אפשר להשתמש בספריית האימות ב-Fleet Engine כדי ליצור אסימוני אינטרנט חתומים בפורמט JSON בסביבת Java. ב-Fleet Engine משתמשים באסימוני JWT כדי להגביל את הגישה לממשקי API שלFleet Engine בסביבות לא מהימנות. ספריית האימות של Fleet Engine מפשטת את היצירה של אסימוני JWT של Fleet Engine ב-Java ומחתימה עליהם בצורה מאובטחת. פרטים נוספים זמינים במאמר ספריית האימות של Fleet Engine ל-Java.
הספרייה מספקת את היתרונות הבאים:
- מפשט את תהליך היצירה של אסימוני Fleet Engine.
- מספקת מנגנוני חתימת אסימונים שאינם שימוש בקובצי פרטי כניסה (כמו התחזות לחשבון שירות).
Node.js / TypeScript
מידע נוסף זמין בכתובת https://www.npmjs.com/package/@googlemaps/fleetengine-delivery
npm
npm install @googlemaps/fleetengine-delivery
Go
ספריית Go נארזת כמודול בכתובת https://pkg.go.dev/cloud.google.com/go/maps
Python
מידע נוסף זמין בכתובת https://pypi.org/project/google-maps-fleetengine-delivery/0.1.0/
תמונה בתוך תמונה
pip install google-auth
pip install google-maps-fleetengine-delivery
C#
הוראות התקנה לספריית C# מופיעות בכתובת https://www.nuget.org/packages/Google.Maps.FleetEngine.Delivery.V1.
PHP
פרטים נוספים זמינים בכתובת https://packagist.org/packages/google/maps-fleetengine-delivery.
Ruby
מידע נוסף זמין בכתובת https://rubygems.org/gems/google-maps-fleet_engine-delivery.