بازیابی اطلاعات سفر

برای دریافت به‌روزرسانی‌های داده‌های سفر از Google Maps یا Waze، بخش مدیریت خود را با استفاده از یکی از گزینه‌های زیر پیکربندی کنید:

  • یک متد pull با استفاده از Navigation Connect API، یا
  • یک روش ارسال رویداد محور با استفاده از Google Cloud Pub/Sub.

گزینه ۱: استفاده از API اتصال ناوبری

برای دریافت دستی آخرین وضعیت سفر، متد GetTrip را با شناسه منحصر به فرد سفر فراخوانی کنید.

نمونه زیر نحوه فراخوانی API از خط فرمان با استفاده از اعتبارنامه‌های پیش‌فرض برنامه (ADC) برای تأیید درخواست سرور به سرور را نشان می‌دهد.

#!/bin/bash

gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"

# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"

سفارشی‌سازی قالب‌های چندخطی (فقط در Waze)

اگر در هنگام ایجاد سفر، گزارش‌دهی مسیر باقیمانده را فعال کرده باشید، می‌توانید نمایش چندخطی مسیر فعال برگشتی را هنگام فراخوانی متد GetTrip سفارشی‌سازی کنید.

برای انتخاب فرمت برای چندخطی، پارامتر routePolylineFormat را در درخواست خود وارد کنید. فرمت‌های پشتیبانی شده شامل موارد زیر هستند:

  • ENCODED : یک رشته چندخطی رمزگذاری شده استاندارد (۵ رقم اعشار).
  • S2ENCODED : یک S2Polyline کدگذاری شده.
  • GEO_JSON : یک قالب GeoJSON LineString.

گزینه ۲: استفاده از Google Cloud Pub/Sub

برای دریافت به‌روزرسانی‌های منظم سفر، در یک موضوع Pub/Sub گوگل کلود مشترک شوید. پس از رضایت راننده، Navigation Connect به‌روزرسانی‌ها را مستقیماً به موضوع شما ارسال می‌کند.

برای آشنایی با پیام‌رسانی، به راهنمای شروع سریع Pub/Sub مراجعه کنید.

بخش‌های زیر نحوه استفاده از Google Cloud Pub/Sub را برای دریافت داده‌ها از یک جلسه ناوبری با Google Maps یا Waze شرح می‌دهند.

۱. ایجاد یک موضوع

یک تاپیک با نام دقیق navigation_connect_trip_notifications در پروژه گوگل کلود خود، به صورت زیر ایجاد کنید:

  1. API مربوط به Pub/Sub را فعال کنید.
  2. به صفحه موضوعات Pub/Sub در کنسول Google Cloud بروید.
  3. روی ایجاد موضوع کلیک کنید.

  4. عبارت navigation_connect_trip_notifications در فیلد شناسه موضوع وارد کنید.

  5. روی ایجاد کلیک کنید.

کنسول نام کامل موضوع را به صورت projects/ project-number /topics/navigation_connect_trip_notifications نمایش می‌دهد، که در آن project-number شماره منحصر به فرد پروژه شماست.

۲. به حساب کاربری سرویس Navigation Connect اجازه انتشار بدهید

گوگل از یک حساب کاربری برای انتشار به‌روزرسانی‌های سفر در موضوعات Google Cloud Pub/Sub استفاده می‌کند. برای دریافت به‌روزرسانی‌ها در موضوع خود، مجوز projects.topics.publish را برای این موضوع به حساب کاربری سرویس زیر اعطا کنید: geo-navigation-connect-pubsub@system.gserviceaccount.com .

برای اطلاعات بیشتر، به مستندات Pub/Sub در مورد کنترل دسترسی مراجعه کنید.

۳. با بک‌اند خود ادغام کنید

برای پردازش به‌روزرسانی‌ها، یک برنامه سمت سرور بنویسید که موضوع شما را احراز هویت و در آن مشترک شود. برای توسعه ساده از کتابخانه‌های Pub/Sub Client استفاده کنید. برای آزمایش، می‌توانید از GCloud CLI و Google Console نیز استفاده کنید.

۴. اشتراک خود را آزمایش کنید

تنظیمات خود را با استفاده از gcloud CLI یا کنسول Google Cloud تأیید کنید.

رابط خط فرمان جی‌کلاود

با استفاده از دستور زیر، پیام‌ها را از یک اشتراک (مثلاً my-sub ) دریافت کنید:

gcloud pubsub subscriptions pull my-sub --auto-ack

کنسول گوگل کلود

در کنسول گوگل کلود، مراحل زیر را انجام دهید:

  1. صفحه اشتراک‌ها را باز کنید.
  2. اشتراک خود را انتخاب کنید و روی برگه پیام‌ها کلیک کنید.
  3. روی کشیدن کلیک کنید.

قدم بعدی چیست؟

به محض اینکه شروع به دریافت داده‌های سفر کردید، داده‌ها را تجزیه و تحلیل کنید تا از آنها در سیستم‌ها و برنامه‌های خود استفاده کنید.

مدیریت داده‌های سفر