بازیابی داده‌های سفر

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

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

گزینه ۱: استفاده از Navigation Connect API

برای واکشی دستی جدیدترین وضعیت سفر، روش GetTrip را با شناسه یکتای سفر فراخوانی کنید.

نمونه زیر نشان می‌دهد که چگونه بااستفاده از «اعتبارنامه پیش‌فرض برنامه» (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"

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

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

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

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

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

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

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

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

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

موضوعی دقیقاً با نام navigation_connect_trip_notifications در پروژه Google Cloud خود به‌صورت زیر ایجاد کنید:

  1. Pub/Sub API را فعال کنید.
  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 از حساب سرویس برای انتشار به‌روزرسانی‌های سفر در موضوعات Google Cloud Pub/Sub استفاده می‌کند. برای دریافت به‌روزرسانی‌ها در موضوعتان، اجازه projects.topics.publish را برای این موضوع به حساب سرویس زیر اعطا کنید: geo-navigation-connect-pubsub@system.gserviceaccount.com.

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

۳. ادغام با پسای شما

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

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

راه‌اندازی‌تان را بااستفاده از gcloud CLI یا کنسول Google Cloud درستی‌سنجی کنید.

gcloud CLI

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

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

;کنسول Google Cloud

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

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

قدم بعدی چیست

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

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