برای ارتباط سرور به سرور (معتمد)، توصیه میکنیم از کتابخانههای کلاینت GAPI مخصوص زبان برای تجربه بهتر نسبت به توسعه روی REST خام یا gRPC استفاده کنید. فایلهای پروتوباف که این کلاینتها بر اساس آنها هستند در https://github.com/googleapis/googleapis/tree/master/google/maps/fleetengine/delivery/v1 در دسترس عموم هستند.
اگر کتابخانه ها در زبان برنامه شما وجود ندارند، توصیه می کنیم از gRPC یا Fleet Engine REST استفاده کنید.
توجه: کتابخانه های GAPIC برای اجرا در محیط های قابل اعتماد (سرور) در نظر گرفته شده است. JWT ها غیر ضروری هستند. از اعتبارنامه های پیش فرض برنامه به همراه نقش deliveryAdmin
مناسب استفاده کنید.
جاوا
کتابخانه های جاوا تحت google.maps.fleetengine.delivery.v1
منتشر می شوند.
گریدل
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'
}
ماون
<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>
میتوانید از کتابخانه تأیید موتور Fleet برای جاوا برای ایجاد نشانههای وب JSON امضاشده در محیط جاوا استفاده کنید.
می توانید نمونه های جاوا را برای تعامل با Fleet Engine API در صفحه شروع به کار با Fleet Engine مشاهده کنید.
Node.js / TypeScript
npm
می توانید URL کتابخانه را در بخش dependencies
در package.json
مشخص کنید:
{
"dependencies": {
"@googlemaps/fleetengine-delivery": "https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/maps-fleetengine-delivery-v1-nodejs.tar.gz",
"google-auth-library": "^9.2.0",
"googleapis": "^118.0.0"
}
}
کد نمونه:
const {google} = require('googleapis');
const fleetengine = require('@googlemaps/fleetengine-delivery');
const {GoogleAuth} = require('google-auth-library');
// CONSTANTS
const PROJECT_ID = 'YOUR_GCP_PROJECT_NAME';
const VEHICLE_ID = 'YOUR_VEHICLE_ID';
const SERVICE_ACCOUNT = 'YOUR_SERVICE_ACCOUNT';
const SERVICE_ACCOUNT_EMAIL = `${SERVICE_ACCOUNT}@${PROJECT_ID}.iam.gserviceaccount.com`;
// CREATE A JWT FOR AUTHENTICATION
const HOWLONG = 55 * 60; // 55 minutes, cannot be more than 60 minutes
async function signToken(claims) {
const googleAuth = new google.auth.GoogleAuth({
scopes: ['https://www.googleapis.com/auth/cloud-platform'],
});
const authClient = await googleAuth.getClient();
google.options({auth: authClient});
const now = Math.round(Date.now() / 1000);
const iat = now - 300;
const exp = now + HOWLONG;
const request = {
name: `projects/-/serviceAccounts/${SERVICE_ACCOUNT_EMAIL}`,
requestBody: {
payload: JSON.stringify({
iss: SERVICE_ACCOUNT_EMAIL,
sub: SERVICE_ACCOUNT_EMAIL,
aud: 'https://fleetengine.googleapis.com/',
iat: iat,
exp: exp,
authorization: claims
}),
}
};
const response = await google.iamcredentials('v1').projects.serviceAccounts
.signJwt(request)
.catch((err) => {
if (err.errors) throw err.errors;
else throw err;
});
return response.data.signedJwt;
}
// MAKE A REQUEST
async function main() {
const claims = {
deliveryvehicleid: VEHICLE_ID
};
signToken(claims).then(token => {
let auth = new GoogleAuth();
auth.cachedCredential = new AuthorizationHeaderProvider(token);
const client = new fleetengine.DeliveryServiceClient({ auth: auth });
client.getDeliveryVehicle({name: `providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}`}).then(function(resp) {
console.log(resp);
}, function(err) {
console.log(err);
});
});
}
class AuthorizationHeaderProvider {
constructor(token) {
this.token = token;
}
getRequestMetadata(url, callback) {
callback(null, {'authorization': `Bearer ${this.token}`});
}
}
main().catch(console.error);
برو
کتابخانه Go به عنوان یک ماژول در https://pkg.go.dev/cloud.google.com/go/maps بسته بندی شده است.
پایتون
به https://pypi.org/project/google-maps-fleetengine-delivery/0.1.0/ مراجعه کنید
پیپ
pip install google-auth
pip install google-maps-fleetengine-delivery
سی شارپ
دستورالعملهای نصب کتابخانه C# را میتوانید در https://www.nuget.org/packages/Google.Maps.FleetEngine.Delivery.V1 بیابید.
PHP
کتابخانه PHP را می توان از https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/google-maps-fleetengine-delivery-v1-php.tar.gz دانلود کرد
روبی
به https://rubygems.org/gems/google-maps-fleet_engine-delivery مراجعه کنید.