راه اندازی اتصال ناوبری

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

اگر آدرس صورتحساب شما در منطقه اقتصادی اروپا باشد، که از ۸ ژوئیه ۲۰۲۵ لازم‌الاجرا است، شرایط خدمات پلتفرم نقشه‌های گوگل (EEA) برای استفاده شما از خدمات اعمال خواهد شد. عملکرد آن بر اساس منطقه متفاوت است. اطلاعات بیشتر .

این سند مراحل لازم برای شروع استفاده از Navigation Connect را شرح می‌دهد.

۱. حساب و صورتحساب مطمئن شوید که پیش‌نیازها را رعایت می‌کنید.

۲. فعال کردن API API را در پروژه Google Cloud خود فعال کنید.

۳. اولین درخواست خود را مطرح کنید یک OAuth را برای ارسال یک درخواست API احراز هویت شده پیکربندی کنید.

API را فعال کنید و برنامه خود را تأیید کنید

این راهنما فرآیند فعال‌سازی API Navigation Connect و تأیید برنامه شما در کنسول Google Cloud را شرح می‌دهد، که به برنامه شما امکان می‌دهد به طور ایمن با Google Maps و Waze ارتباط برقرار کند. برای استفاده از API Navigation Connect باید این فرآیند را تکمیل کنید.

۱. فعال کردن API اتصال ناوبری

از کنسول گوگل کلود یا دستور gcloud برای فعال کردن API اتصال ناوبری در پروژه گوگل کلود خود استفاده کنید.

برای فعال کردن API، مراحل زیر را انجام دهید:

کنسول

1. صفحه محصول را در کنسول Google Cloud باز کنید:

   فعال کردن API اتصال ناوبری

2. روی دکمه فعال کردن کلیک کنید.

   توجه: اگر API از قبل فعال شده باشد، به جای فعال کردن، دکمه مدیریت (Manage ) را مشاهده خواهید کرد.

جی‌کلاود

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

• gcloud services enable
• gcloud services disable

۲. فرآیند تأیید برنامه را شروع کنید

پس از فعال کردن API، باید برنامه خود را برای فعال کردن API Navigation Connect تأیید کنید. فعال کردن API به تنهایی به معنای اعطای دسترسی نیست؛ قبل از اینکه بتوانید از API Navigation Connect استفاده کنید، باید جزئیات کسب و کار و برنامه را برای بررسی ارائه دهید.

برای شروع فرآیند تأیید، از یکی از روش‌های زیر استفاده کنید:

• بازار API:
  1. در بازار API ، کارت API مربوط به Navigation Connect را پیدا کنید.
  2. برای شروع فرآیند تأیید، روی آیکون آبی رنگ که نیاز به تأیید دارد کلیک کنید.
• کلیدها و اعتبارنامه‌ها در کنسول گوگل کلود:
  1. در کنسول گوگل کلود، به صفحه کلیدها و اعتبارنامه‌ها بروید.
  2. روی «کلیدهای اتصال و اعتبارنامه‌های ناوبری» کلیک کنید.
  3. در بنر، روی «شروع تأیید» کلیک کنید.

۳. جزئیات برنامه، جمع‌آوری داده‌ها و حریم خصوصی را ارائه دهید

جدول زیر جزئیاتی را که باید برای تأیید برنامه ارائه دهید شرح می‌دهد:

میدان	توضیحات
جزئیات برنامه برای اطمینان از نمایش صحیح برنامه‌تان در Google Maps و Waze، جزئیات زیر را ارائه دهید.
نام کسب و کار یا اپلیکیشن	نامی را که می‌خواهید در Google Maps و Waze به کاربران نمایش داده شود، وارد کنید.
شناسه برنامه	نام بسته اندروید یا شناسه بسته iOS خود را وارد کنید.
لینک جهانی iOS	لینک جهانی iOS را ارائه دهید که به کاربران امکان بازگشت به برنامه شما را می‌دهد (فقط در Waze موجود است).
لوگوی برنامه (فقط Waze)	(اختیاری) یک لوگوی PNG یا JPG (با ابعاد ۳۲x۳۲ تا ۱۲۸x۱۲۸ پیکسل) آپلود کنید تا لوگوی برنامه شما در Waze در طول یک جلسه ناوبری نمایش داده شود.
جمع‌آوری داده‌ها و جزئیات حریم خصوصی برای اطمینان از شفافیت، اعتماد راننده و امنیت داده‌ها، جزئیات زیر را وارد کنید.
لینک سیاست حفظ حریم خصوصی	آدرس اینترنتی (URL) مربوط به سیاست حفظ حریم خصوصی برنامه خود را ارائه دهید. این پیوند در صفحه رضایت‌نامه نمایش داده می‌شود.
کنترل‌کننده‌های داده اضافی (اختیاری)	نام تجاری و لینک سیاست حفظ حریم خصوصی را برای هر مدیر داده شخص ثالث، مانند ISV، ارائه دهید. این جزئیات در صفحه رضایت‌نامه ظاهر می‌شوند.
انطباق داده‌ها	اگر برنامه شما در ایالات متحده فعالیت می‌کند، برای اطمینان از رعایت مقررات محلی، گزینه «این برنامه برای سفرهایی که در ایالات متحده رخ می‌دهد استفاده خواهد شد» را علامت بزنید.

۴. بررسی و ارسال

قبل از ارسال برنامه خود برای تأیید، خلاصه اطلاعات ارائه شده خود را مرور کنید.

1. نام، پلتفرم، شناسه‌ها و لینک‌های برنامه خود را با دقت بررسی کنید.

   توجه: پس از ارسال درخواست، نمی‌توانید این جزئیات را ویرایش کنید.
2. کادر انتخاب «همه اطلاعات دقیق هستند» را علامت بزنید.
3. روی ارسال کلیک کنید.

پس از ارسال برنامه خود برای تأیید، مرحله بررسی آغاز می‌شود.

• جدول زمانی: تأیید معمولاً ۱ تا ۳ روز کاری طول می‌کشد.
• اعلان: وقتی وضعیت تأیید تغییر می‌کند، ایمیلی دریافت می‌کنید. همچنین ایمیلی دریافت می‌کنید که شناسه نمایه پرداخت یا شناسه توسعه‌دهنده اندروید شما را درخواست می‌کند. اگر به شناسه توسعه‌دهنده اندروید نیاز دارید، به ایجاد حساب توسعه‌دهنده مراجعه کنید.
• پیگیری وضعیت: پیشرفت خود را در صفحه کلیدها و اعتبارنامه‌ها در کنسول Google Cloud پیگیری کنید.
• پشتیبانی: برای به‌روزرسانی پیکربندی خود پس از تأیید بدون تأثیر بر تولید، یک تیکت پشتیبانی ایجاد کنید.

پس از تأیید، برنامه شما مجاز به استفاده از API Navigation Connect برای تولید توکن‌های سفر است که دسترسی به یک جلسه ناوبری را مجاز می‌کنند و به شما امکان می‌دهند جزئیات سفر را از Google Maps و Waze دریافت کنید.