서버 간 통신을 위한 원시 REST 또는 gRPC를 통해 개발하는 것보다 더 나은 경험을 위해 Google의 언어별 GAPI 클라이언트 라이브러리를 사용하는 것이 좋습니다.
애플리케이션의 언어에 라이브러리가 없으면 gRPC 또는 Fleet Engine REST 엔드포인트를 사용하는 것이 좋습니다.
Fleet Engine으로 인증하려면 서명된 JSON 웹 토큰이 있어야 합니다. 자세한 내용은 인증 및 승인을 참조하세요.
Java
자바 라이브러리는 google.maps.fleetengine.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-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-v1-java</artifactId>
<version>LATEST</version>
</dependency>
</project>
자바용 Fleet Engine 인증 라이브러리를 활용하여 자바 환경 내에서 서명된 JSON 웹 토큰을 만들 수 있습니다.
Fleet Engine 시작하기 페이지에서 Fleet Engine API와 상호작용하기 위한 자바 예시를 볼 수 있습니다.
Node.js / TypeScript
npm
package.json의 dependencies 섹션에서 라이브러리 URL을 지정할 수 있습니다.
{
"dependencies": {
"@googlemaps/fleetengine": "https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/maps-fleetengine-v1-nodejs.tar.gz",
"googleapis": "^118.0.0"
}
}
샘플 코드:
const {google} = require("googleapis");
const iamcredentials = google.iamcredentials("v1");
const fleetengine = require("@googlemaps/fleetengine");
// 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 iamcredentials.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 = {
vehicleid: VEHICLE_ID
};
signToken(claims).then(token => {
let auth = new GoogleAuth();
auth.cachedCredential = new AuthorizationHeaderProvider();
const client = new fleetengine.VehicleServiceClient({ auth: auth });
client.getVehicle({parent: `providers/${PROJECT_ID}`}).then(function(resp) {
console.log(resp);
}, function(err) {
console.log(err);
});
});
}
class AuthorizationHeaderProvider {
getRequestMetadata(url, callback) {
callback(null, {'authorization': `Bearer ${token}`});
}
}
main().catch(console.error);
Go
Go 라이브러리는 https://pkg.go.dev/google.golang.org/genproto/googleapis/maps/fleetengine/v1에서 모듈로 패키징됩니다.
package main
import (
"context"
"fmt"
"os"
"time"
"google.golang.org/grpc"
"google.golang.org/grpc/credentials"
"google.golang.org/grpc/metadata"
credentials "cloud.google.com/go/iam/credentials/apiv1"
credentialspb "cloud.google.com/go/iam/credentials/apiv1/credentialspb"
fleetengine "google.golang.org/genproto/googleapis/maps/fleetengine/v1"
)
func (a *auth) signToken(ctx context.Context, email string, iat time.Time, exp time.Time, aud string, scope string, privateClaims map[string]any) (string, error) {
claimSet := struct {
Iss string `json:"iss"`
Sub string `json:"sub"`
Aud string `json:"aud"`
Scope string `json:"scope"`
Iat int64 `json:"iat"`
Exp int64 `json:"exp"`
Authorization any `json:"authorization"`
}{email, email, aud, scope, iat.Unix(), exp.Unix(), nil}
if privateClaims != nil {
if auth, ok := privateClaims["authorization"]; ok {
claimSet.Authorization = auth
}
}
// Create a new connection per request to ensure we're not using a stale context.
client, err := credentials.NewIamCredentialsClient(ctx)
if err != nil {
return "", fmt.Errorf("Could not instantiate IAM credentials client: %v", err)
}
payloadJSON, err := json.Marshal(claimSet)
if err != nil {
return "", fmt.Errorf("Could not marshal JWT payload: %v", err)
}
req := &credentialspb.SignJwtRequest{
Name: fmt.Sprintf("projects/-/serviceAccounts/%s", email),
Payload: string(payloadJSON),
JwtType: "JWT",
}
resp, err := client.SignJwt(ctx, req)
if err != nil {
return "", fmt.Errorf("SignJwt request failed with error: %v", err)
}
return resp.SignedJwt, nil
}
func main() {
project_id := "YOUR_GCP_PROJECT_NAME"
vehicle_id := "YOUR_VEHICLE_ID"
service_account_name := "YOUR_SERVICE_ACCOUNT"
service_account_email := fmt.Sprintf("%s@%s.iam.gserviceaccount.com", service_account_name, project_id)
ctx := context.Background()
iat := time.Now().Add(-time.Minute * 5)
exp := time.Now().Add(time.Minute * 55)
aud := "https://fleetengine.googleapis.com/"
scope := "https://www.googleapis.com/auth/cloud-platform"
claims := map[string]string{
"vehicleid": vehicle_id,
}
token := signToken(ctx, service_account_email, iat, exp, aud, scope, claims)
opts := []grpc.DialOption{
grpc.WithTransportCredentials(credentials.NewClientTLSFromCert(nil, "")),
}
auth_header := string(fmt.Sprintf("Bearer %s", token))
address := "fleetengine.googleapis.com:443"
ctx = metadata.AppendToOutgoingContext(ctx, "authorization", auth_header)
conn, _ := grpc.DialContext(ctx, address, opts...)
request := &fleetengine.GetVehicleRequest {
Name: fmt.Sprintf("providers/%s/vehicles/%s", project_id, vehicle_id),
}
svc := fleetengine.NewVehicleServiceClient(conn)
response, err := svc.GetVehicle(ctx, request)
if (err != nil) {
fmt.Println(err)
return
}
fmt.Println(response)
}
Python
pip
pip install google-auth
pip install https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/maps-fleetengine-v1-py.tar.gz
샘플 코드:
from maps import fleetengine_v1
import google.auth
from google.auth import jwt
from google.auth import iam
from google.auth.transport import requests
# CONSTANTS
PROJECT_ID = 'YOUR_GCP_PROJECT_NAME'
VEHICLE_ID = 'YOUR_VEHICLE_ID'
SERVICE_ACCOUNT = f'YOUR_SERVICE_ACCOUNT@{PROJECT_ID}.iam.gserviceaccount.com'
# CREATE A JWT FOR AUTHENTICATION
credentials, _ = google.auth.default(scopes=['https://www.googleapis.com/auth/iam'])
signer = iam.Signer(requests.Request(), credentials, SERVICE_ACCOUNT)
jwt_credentials = jwt.Credentials(
signer,
issuer=SERVICE_ACCOUNT,
subject=SERVICE_ACCOUNT,
audience='https://fleetengine.googleapis.com/',
additional_claims={
"authorization": {
"vehicleid" : VEHICLE_ID
}
}
)
# MAKE A REQUEST
maps_fleetengine_client = fleetengine_v1.VehicleServiceClient(credentials=jwt_credentials)
request = fleetengine_v1.GetVehicleRequest(name=f'providers/{PROJECT_ID}/vehicles/{VEHICLE_ID}')
response = maps_fleetengine_client.get_vehicle(request=request)
C#
C# 라이브러리는 https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/google-maps-fleetengine-v1-csharp.tar.gz에서 다운로드할 수 있습니다.
2,399필리핀
PHP 라이브러리는 https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/google-maps-fleetengine-v1-php.tar.gz에서 다운로드할 수 있습니다.
Ruby
Ruby 라이브러리는 https://storage.googleapis.com/fleetengine-gapic/dist/latest_release/google-maps-fleetengine-v1-ruby.tar.gz에서 다운로드할 수 있습니다.