سوالات متداول پلتفرم نقشه های گوگل

شروع به کار

شرایط خدمات را درک کنید

محدودیت استفاده و صورتحساب

از پلتفرم نقشه های گوگل استفاده کنید

خطاها و عیب یابی

خدمات پلتفرم نقشه های گوگل

Maps JavaScript API

Google Maps SDK برای iOS

Google Maps SDK برای اندروید

امضای URL

شروع به کار

پلتفرم نقشه های گوگل چیست؟

Google Maps Platform مجموعه‌ای از API و SDK است که به توسعه‌دهندگان اجازه می‌دهد نقشه‌های Google را در برنامه‌های موبایل و صفحات وب جاسازی کنند یا داده‌ها را از Google Maps بازیابی کنند. چندین پیشنهاد وجود دارد. بسته به نیازتان، ممکن است متوجه شوید که از یک یا ترکیبی از این API ها و SDK ها استفاده می کنید:

نقشه ها:

مسیرها:

مکان ها:

محیط زیست:

چگونه می توانم با Google Maps Platform شروع کنم؟

به شروع با پلتفرم نقشه های Google مراجعه کنید.

به کدام API نیاز دارم؟

برای کمک به یافتن API مناسب بر اساس نیازهای عملکردی خود، نگاهی به انتخابگر API بیندازید.

چگونه می توانم از API ها در سایت خود استفاده کنم؟

راهنمای نمای کلی، توسعه‌دهنده و شروع به کار را برای API یا SDK خاصی که به آن علاقه دارید، ببینید. برای مثال، راهنمای Maps SDK برای Android یا Maps JavaScript API را بررسی کنید.

پلتفرم نقشه های گوگل کدام کشورها را پوشش می دهد؟

تیم Google Maps دائماً داده‌های نقشه جدید را بیرون می‌آورد و پوشش بین‌المللی ما را افزایش می‌دهد. برای آخرین اطلاعات پوشش، با داده های پوشش Google Maps مشورت کنید. می توانید داده ها را با کادر فیلتر در بالای صفحه فیلتر کنید. در صورت تغییر موافقت نامه های مجوز با ارائه دهندگان داده، داده های پوشش می توانند تغییر کنند.

همچنین ببینید:

آیا می توانم بدون استفاده از محصولات پلتفرم نقشه های گوگل، نقشه های گوگل را در سایت خود قرار دهم؟

بله Google Maps اکنون امکان جاسازی نقشه‌ای را که در حال مشاهده آن هستید در وب‌سایت یا وبلاگ خود، بدون برنامه‌نویسی یا استفاده از پلتفرم Google Maps ارائه می‌دهد. اطلاعات بیشتر در اینجا موجود است.

چگونه برنامه های Maps را در دستگاه های تلفن همراه ارائه کنم؟

برای گنجاندن نقشه ها در یک برنامه Android، از Maps SDK برای Android استفاده کنید.

برای گنجاندن نقشه ها در یک برنامه iOS، از Maps SDK برای iOS استفاده کنید.

Maps JavaScript API برای پاسخگویی به دستگاه‌های تلفن همراه توسعه یافته است و برای برنامه‌های مرورگر که هم روی دسکتاپ و هم دستگاه‌هایی که شامل یک مرورگر وب با پیاده‌سازی کامل جاوا اسکریپت هستند، مناسب است، مانند Apple iPhone.

برای برنامه‌هایی که دستگاه‌هایی را هدف قرار می‌دهند که برای استفاده از Maps JavaScript API مناسب نیستند، Maps Static API تصاویر نقشه را در قالب‌های GIF، JPG، و PNG، از جمله نشانگرها و چند خطوط ارائه می‌کند. توجه داشته باشید که استفاده از Maps Static API خارج از برنامه‌های مبتنی بر مرورگر مستلزم پیوند تصویر نقشه به Google Maps است.

Maps JavaScript API و Maps Embed API از کدام مرورگرهای وب پشتیبانی می کند؟

Maps JavaScript API و Maps Embed API از مرورگرهای وب زیر پشتیبانی می‌کنند:

دسکتاپ
  • نسخه فعلی Microsoft Edge (ویندوز)، به استثنای حالت اینترنت اکسپلورر.
  • دو آخرین نسخه اصلی پایدار فایرفاکس (ویندوز، macOS، لینوکس).
  • دو آخرین نسخه اصلی پایدار کروم (ویندوز، macOS، لینوکس).
  • دو آخرین نسخه اصلی پایدار سافاری (macOS).
اندروید
  • نسخه فعلی Chrome در Android نسخه 4.1 و بالاتر.
  • Chrome WebView در Android 4.4 و بالاتر.
iOS
  • سافاری موبایل در نسخه های اصلی فعلی و قبلی iOS.
  • UIWebView و WKWebView در نسخه های اصلی فعلی و قبلی iOS.
  • نسخه فعلی کروم برای iOS.
آیا می توانم نقشه ها را از Maps JavaScript API چاپ کنم؟

چاپ از Maps JavaScript API پشتیبانی نمی شود. این به این دلیل است که پشتیبانی از چاپ در مرورگرهای رایج ناسازگار است.

وقتی تغییراتی در محصولات پلتفرم Google Maps ایجاد می شود، چگونه می توانم مطلع شوم؟

برای به روز رسانی اخبار در مورد پیشنهادات مختلف توسعه دهندگان Google Geo، باید در وبلاگ پلتفرم نقشه های Google مشترک شوید.

چگونه با پشتیبانی فنی تماس بگیرم؟

برای اطلاعات در مورد گزینه های پشتیبانی موجود ، به پشتیبانی و منابع پلتفرم نقشه های Google مراجعه کنید.

چه زمانی پشتیبانی فنی در دسترس است؟
تیم پشتیبانی 24×5 (روزهای هفته از دوشنبه 9 صبح به وقت توکیو تا جمعه 5 بعد از ظهر به وقت اقیانوس آرام) به استثنای تعطیلات منطقه ای برای مشکلات "خدمات غیرقابل استفاده" در دسترس است.
چگونه می توانم دسترسی به حساب Google خود را بازیابی کنم؟

اگر دسترسی به حساب Google خود را از دست دادید (به عنوان مثال joe@mycompany.com یا joe@gmail.com)، می توانید با بازیابی یا تنظیم مجدد رمز عبور، دسترسی به حساب را بازیابی کنید. به مقاله نحوه بازیابی حساب Google یا Gmail خود در راهنمای حساب Google مراجعه کنید.

چگونه می توانم دسترسی به یک پروژه خاص را بازیابی کنم؟

اگر دسترسی به پروژه ای را که در آن پیاده سازی پلتفرم Google Maps خود را مدیریت می کنید از دست دادید، می توانید سعی کنید آن را بازیابی کنید.

اگر به حساب Google مرتبط با پروژه خود دسترسی دارید:

اگر به حساب Google مرتبط با پروژه خود دسترسی ندارید :

آیا می توانم از Maps and Places SDK برای iOS در Mac های مبتنی بر Arm استفاده کنم؟

توسعه بر روی Mac های جدید مبتنی بر Arm امکان پذیر است، با این حال، نیاز به ساخت و اجرا بر روی یک دستگاه فیزیکی iOS دارد. این یک محدودیت موقتی است در حالی که ما به دنبال اضافه کردن پشتیبانی بیشتر برای توسعه در شبیه سازها هستیم.

شرایط خدمات را درک کنید

شرایط خدمات برای محصولات پلتفرم Google Maps چیست؟

شرایط خدمات پلتفرم Google Maps در آدرس زیر موجود است:

https://cloud.google.com/maps-platform/terms

آیا سایت من شرایط خدمات پلتفرم Google Maps را رعایت می کند؟

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

با این حال، برخی از کاربردهای پلتفرم نقشه های گوگل وجود دارد که ما نمی خواهیم آنها را ببینیم. به عنوان مثال، نقشه هایی که مکان های خرید مواد مخدر غیرقانونی در یک شهر یا هر فعالیت غیرقانونی دیگری را مشخص می کند. ما همچنین به حریم خصوصی افراد احترام می گذاریم، بنابراین پلتفرم Google Maps نباید برای شناسایی اطلاعات خصوصی افراد استفاده شود.

قبل از توسعه و راه‌اندازی، باید از مشاوره خود برای تعیین اینکه آیا برنامه شما با شرایط خدمات پلتفرم Google Maps مطابقت دارد یا خیر استفاده کنید. مهندسان Google فقط می توانند کمک فنی ارائه دهند و صلاحیت ارائه مشاوره حقوقی را ندارند. Google این حق را برای خود محفوظ می دارد که در هر زمانی استفاده شما از این سرویس را تعلیق یا خاتمه دهد، بنابراین شرایط Maps APIs را به دقت بخوانید.

آیا می توانم مستقیماً به کاشی های نقشه و تصاویر ماهواره ای دسترسی داشته باشم؟

شما نمی توانید از طریق مکانیسمی غیر از پلتفرم نقشه های گوگل (مانند ایجاد API نقشه برداری خود یا استفاده از اسکریپت دانلود انبوه کاشی) به کاشی های نقشه یا تصاویر ماهواره ای دسترسی پیدا کنید. اگر برنامه شما خارج از پلتفرم Google Maps به آنها دسترسی داشته باشد، دسترسی به کاشی‌ها مسدود می‌شود. برای جزئیات بیشتر به شرایط خدمات پلتفرم Google Maps مراجعه کنید.

آیا می توانم از محصولات پلتفرم نقشه های گوگل برای ردیابی برنامه ها استفاده کنم؟

هیچ محدودیتی برای نمایش داده‌های بی‌درنگ (ردیابی) با محصولات پلتفرم Google Maps وجود ندارد، مشروط بر اینکه برنامه با شرایط خدمات پلتفرم Google Maps مطابقت داشته باشد.

آیا می توانم از Google Maps در برنامه غیر وب خود استفاده کنم؟

بله، محصولات Google Maps Platform اکنون می توانند در برنامه های غیر وب استفاده شوند، مشروط بر اینکه از سایر محدودیت های شرایط خدمات پلت فرم Google Maps پیروی کنند.

Maps JavaScript API تنها زمانی پشتیبانی می شود که در یکی از مرورگرهای پشتیبانی شده اجرا شود.

آیا می توانم از محصولات پلتفرم نقشه های گوگل در سایتی استفاده کنم که دارای رمز عبور است؟

بله، خدمات Google Maps، Routes، Places و Environment را می توان با برنامه های کاربردی دسترسی خصوصی استفاده کرد. برای جزئیات بیشتر به شرایط خدمات پلتفرم Google Maps مراجعه کنید.

آیا می توانم برنامه ای ایجاد کنم که شامل داده های پلتفرم نقشه های گوگل در یک سند باشد؟

اگر برنامه شما سندی را به صورت الکترونیکی یا چاپی تولید می‌کند، هیچ داده‌ای از پلتفرم نقشه‌های Google، از جمله تصاویر، در سند گنجانده نمی‌شود. برای جزئیات بیشتر به بخش شرایط خدمات پلتفرم Google Maps "بدون خراش دادن" مراجعه کنید.

چگونه می توانم از گنجاندن محتوای خود در نتایج جستجوی Google انصراف دهم؟

ما دیگر این داده ها را جمع آوری نمی کنیم. استفاده از پارامتر indexing منسوخ شده است و هیچ تاثیری ندارد. دیگر نیازی به انصراف صریح ندارید، اما ما شما را تشویق می‌کنیم که این پارامتر را در اولین فرصت خود حذف کنید.

برای حذف صفحه یا سایت خود از نتایج جستجو، دستورالعمل های ارائه شده در مرکز راهنمایی ما را دنبال کنید.

آیا می توانم با استفاده از Maps Static API که از وب سایت خود ذخیره و ارائه می کنم یک تصویر نقشه ایجاد کنم؟

شما نمی توانید کپی هایی از تصاویر تولید شده با استفاده از Maps Static API را از وب سایت خود ذخیره و ارائه دهید. همه صفحات وب که به تصاویر ثابت نیاز دارند باید ویژگی src یک تگ img HTML یا ویژگی background-image CSS یک تگ div HTML را مستقیماً به Maps Static API پیوند دهند تا همه تصاویر نقشه در محتوای HTML صفحه وب نمایش داده شوند و مستقیماً توسط Google به کاربران نهایی ارائه شوند.

محدودیت استفاده و صورتحساب

چگونه صورتحساب پروژه خود را تنظیم کنم؟
به شروع با پلتفرم نقشه های Google مراجعه کنید.
چگونه مشتریان Google Cloud Free Tier به یک حساب پولی ارتقا می‌دهند؟
برنامه Google Cloud Free Tier یک دوره آزمایشی بدون هزینه با اعتبار 300 دلاری برای استفاده با هر سرویس Google Cloud، از جمله APIهای پلتفرم Google Maps (GMP) به مشتریان ارائه می دهد. پس از پایان دوره آزمایشی رایگان، برای ادامه استفاده از این خدمات، باید به یک حساب پولی ارتقا دهید . برای ارتقاء به یک حساب پولی، از کنسول Cloud دیدن کنید.
آیا پلتفرم نقشه گوگل محدودیت استفاده دارد؟

هیچ محدودیت روزانه حداکثری برای تعداد درخواست‌هایی که می‌توانید به محصولات پلتفرم Google Maps بدهید وجود ندارد و تنها محدودیت‌های استفاده مربوط به حداکثر تعداد درخواست‌ها در دقیقه (QPM) است.

جدول زیر محدودیت استفاده برای هر API را نشان می دهد. می‌توانید محدودیت‌های سهمیه را در Cloud Console مشاهده و تغییر دهید.

API محدودیت استفاده
اعتبار سنجی آدرس 6000 QPM
نمای هوایی: جستجوی ویدیو 180 QPM و 100000 QPD
نمای هوایی: رندر ویدیو 100 QPM و 100 QPD
کیفیت هوا 6000 QPM
نقشه های پویا 30000 QPM
ارتفاع 6000 QPM
ژئوکدینگ 3000 QPM
موقعیت جغرافیایی 6000 QPM
Map Tiles API: کاشی‌های دوبعدی و کاشی‌های نمای خیابان 6000 QPM و 15000 QPD
Map Tiles API: کاشی های سه بعدی فوتورئالیستی 10000 QPD
Map Tiles API: Photorealistic 3D Tiles: Renderer 12000 QPM
ناوبری: درخواست های مقصد را تنظیم کنید 30000 QPM
مکان ها 6000 QPM
گرده 6000 QPM
جاده ها 30000 QPM
مسیرها: محاسبه مسیرها 3000 QPM
مسیرها: محاسبه مسیر ماتریس 3000 EPM
خورشیدی 600 QPM
نقشه های ایستا 30000 QPM
API تصویر نمای خیابان 30000 QPM
منطقه زمانی 30000 QPM

به منظور کنترل هزینه‌ها، می‌توانید استفاده از API خود را کنترل کنید و محدودیت‌های روزانه برای همه درخواست‌ها برای هر API قابل پرداختی تعیین کنید .

محصولات Google Maps Platform باید مطابق با شرایط خدمات استاندارد Google Maps Platform مستقر شوند.

هزینه استفاده چگونه محاسبه می شود؟

برای مروری بر قیمت محصولات پلتفرم Google Maps، به لیست قیمت‌ها مراجعه کنید.

برای کسب اطلاعات بیشتر در مورد نحوه صورت‌حساب APIهای پلتفرم Google Maps، به نمای کلی صورت‌حساب و قیمت پلتفرم Google Maps مراجعه کنید.

بارهای نقشه در پلتفرم Google Maps چگونه محاسبه می شود؟

زمانی که هر یک از موارد زیر رخ می دهد، یک بار نقشه واحد شارژ می شود:

  • یک صفحه وب یا برنامه یک نقشه را با استفاده از Maps JavaScript API نمایش می دهد.
  • یک برنامه یک تصویر نقشه واحد را از Maps Static API درخواست می کند.

هزینه پانورامای نمای خیابان به طور جداگانه از بارهای نقشه دریافت می شود:

  • یک پانورامای استاتیک نمای خیابان برای هر درخواست به API استاتیک نمای خیابان برای جاسازی یک پانورامای نمای خیابان ثابت (غیر تعاملی) هزینه می‌شود.
  • برای هر نمونه از یک شی پانوراما در Maps JavaScript API، Maps SDK برای Android یا Maps SDK برای iOS، هزینه پانورامای نمای خیابان پویا دریافت می‌شود.

پس از اینکه یک صفحه وب یا برنامه یک نقشه، یا یک تصویر نقشه ایستا، یا یک پانورامای نمای خیابان را بارگیری کرد، هرگونه تعامل کاربر با آن، مانند جابجایی، بزرگنمایی، یا تغییر لایه های نقشه، بارگذاری نقشه اضافی ایجاد نمی کند یا بر محدودیت های استفاده تأثیر نمی گذارد.

افزودن نشانگر بارهای نقشه اضافی ایجاد نمی کند، اما ممکن است هزینه هایی را در مورد نحوه تعیین مکان پین ایجاد کند (مانند بارگیری یا بارگیری مجدد کلاس google.maps.Map() .)

چگونه بر استفاده خود نظارت کنم؟

می‌توانید استفاده از APIهای جداگانه را در کنسول Google Cloud نظارت کنید.

  1. پروژه ای را که حاوی API مورد نظر برای بررسی است انتخاب کنید.
  2. از لیست APIها در داشبورد، روی نام API کلیک کنید.
  3. در نزدیکی بالای صفحه، روی معیارها یا سهمیه‌ها کلیک کنید.

برای مشاهده گزارش ترافیک و اطلاعات صورتحساب کل پروژه، این مراحل را دنبال کنید:

  1. اگر قبلاً این کار را نکرده‌اید، صورت‌حساب را تنظیم کنید .
  2. به صفحه صورتحساب کنسول Cloud بروید.
  3. یک پروژه را انتخاب کنید.
  4. در نوار کناری سمت چپ، روی گزارش‌ها کلیک کنید. از فیلترهای موجود در نوار کناری سمت راست برای مشاهده گزارش های حساب صورتحساب خود استفاده کنید.

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

اگر از محدودیت های نرخ درخواست (QPM) تجاوز کنم چه اتفاقی می افتد؟

اگر از محدودیت‌های QPM یک محصول پلتفرم Google Maps تجاوز کنید، API یک پیام خطا برمی‌گرداند. اگر مکرراً از محدودیت ها تجاوز کنید، ممکن است دسترسی شما به API به طور موقت مسدود شود.

اگر از محدودیت‌های QPM درخواست تجاوز کنید یا در غیر این صورت از سرویس سوء استفاده کنید، درخواست‌ها یک پیام خطای خاص برمی‌گردانند. اگر همچنان از محدودیت ها تجاوز کنید، ممکن است دسترسی شما به پلتفرم نقشه های Google مسدود شود.

توجه: APIهای وب سرویس زیر دارای یک سرویس مشابه در سمت سرویس گیرنده هستند که در Maps JavaScript API موجود است: Elevation ، Geocoding .

از محدودیت های استفاده فراتر رفت

اگر از محدودیت‌های استفاده فراتر رفتید، یک کد وضعیت OVER_QUERY_LIMIT به عنوان پاسخ دریافت می‌کنید.

این پیام به این معنی است که وب سرویس ارائه پاسخ‌های عادی را متوقف کرده است و تا زمانی که استفاده بیشتر مجاز شود، فقط به بازگرداندن کد وضعیت OVER_QUERY_LIMIT روی آورده است. این سناریو می تواند در عرض چند ثانیه اتفاق بیفتد، اگر خطا دریافت شده باشد زیرا برنامه شما درخواست های زیادی در دقیقه ارسال کرده است.

اگر مرتباً از محدودیت‌های استفاده QPM خود فراتر می‌روید، با بهینه‌سازی برنامه‌ها برای استفاده مؤثرتر از محصولات پلتفرم Google Maps، میزان مصرف را کاهش دهید یا درخواست کنید سهمیه خود را افزایش دهید. برای اطلاعات بیشتر به راهنمای بهینه سازی مراجعه کنید.

سایت من ترافیک زیادی می گیرد. آیا می توانم از محصولات پلتفرم نقشه های گوگل استفاده کنم؟

بله با این حال، توصیه می‌کنیم که با محدودیت‌های استفاده برای هر یک از پلتفرم‌های Google Maps که برنامه شما به آن متکی است آشنا شوید.

هنگامی که یک حساب صورت‌حساب دارید، اگر از سقف استفاده رایگان فراتر رفتید و روش پرداخت معتبری در حساب صورت‌حساب خود ندارید (مانند کارت اعتباری یا حواله بانکی)، API تا زمانی که یک روش پرداخت معتبر اضافه نکنید، از کار می‌افتد.

میزان مصرف چگونه محاسبه و صورتحساب می شود؟

میزان استفاده در پایان هر روز محاسبه می‌شود و طبق لیست قیمت‌گذاری نشان داده شده است. در پایان هر ماه، کل استفاده از روش پرداخت مربوط به حساب صورت‌حساب شما محاسبه می‌شود. برای اطلاعات بیشتر، صورت‌حساب پلتفرم Google Maps را ببینید.

هزینه استفاده از پلتفرم نقشه های گوگل چقدر است؟

برای بررسی کلی هزینه هر API به لیست قیمت‌ها مراجعه کنید. اگر برنامه شما درخواست ها یا حجم بارگذاری نقشه را تا سقف استفاده رایگان برای یک ماه معین ایجاد کند، هزینه استفاده شما محاسبه نمی شود. استفاده ای که بیش از سقف استفاده رایگان باشد به حساب صورتحساب شما کسر می شود. برای جزئیات بیشتر، صورت‌حساب پلتفرم Google Maps را ببینید.

آیا قیمت گذاری به ارزهای دیگر موجود است؟

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

من صورتحساب را تنظیم کرده ام. چگونه صورتحساب خود را مشاهده کنم؟

Google در ابتدای هر ماه هزینه فعالیت ماه قبل را با استفاده از روش پرداخت مشخص‌شده از شما دریافت می‌کند. برای جزئیات درباره صورتحساب خود، به صورت‌حساب پلتفرم Google Maps ما مراجعه کنید.

منابع اضافی:

اگر مصرف من به طور غیرمنتظره افزایش یابد، چگونه می توانم از یک صورت حساب بزرگ جلوگیری کنم؟

پلتفرم نقشه های گوگل راه هایی برای تعیین محدودیت های درخواست روزانه و تعیین حداکثر محدودیت های قابل پرداخت روزانه ارائه می دهد. برای محافظت در برابر افزایش‌های غیرمنتظره، می‌توانید حداکثر محدودیت روزانه استفاده را محدود کنید. همچنین می‌توانید هشدارهای بودجه را تنظیم کنید تا زمانی که هزینه‌های حساب صورت‌حساب به آستانه‌ای که شما تعیین کرده‌اید، اعلان‌های ایمیلی دریافت کنید.

محدود کردن حداکثر سقف قابل پرداخت روزانه:

برای جلوگیری از قبض زیاد، می توانید یک سقف روزانه برای استفاده در نظر بگیرید تا از افزایش غیرمنتظره استفاده محافظت کنید. می توانید این محدودیت را در کنسول Cloud تغییر دهید

تنظیم و مدیریت هشدارهای بودجه:

هشدارهای بودجه را برای ارسال اعلان‌های ایمیلی به سرپرستان صورت‌حساب زمانی که هزینه‌های حساب صورت‌حساب به آستانه‌ای که شما تعیین کرده‌اید رسید، تنظیم کنید . زمانی که هزینه‌های تخمینی حساب صورت‌حساب از 50%، 90% و 100% آستانه فراتر رفت، اعلان‌های ایمیل به مدیران صورت‌حساب ارسال می‌شود.

پیامی دریافت کردم مبنی بر اینکه پروژه من به "حساب انتقال پلتفرم Google Maps" مرتبط است، اما من به آن حساب دسترسی ندارم. چه کار کنم؟

«حساب انتقال پلتفرم Google Maps» برای کمک به مشتریان خاصی ایجاد شد تا به طرح قیمت‌گذاری پرداختی ما کمک کنند. این حساب انتقالی Google را قادر می‌سازد تا به این مشتریان اعتباری یک‌باره ارائه دهد تا بتوانند تا سقف ردیف بدون هزینه به استفاده از پلتفرم Google Maps ادامه دهند. پس از تجاوز از این حد، حساب صورت‌حساب بسته می‌شود و دسترسی به سرویس را از دست خواهید داد. برای جلوگیری از وقفه در سرویس، از شما می‌خواهیم حساب صورت‌حساب خود را تنظیم کنید و همچنان از سقف استفاده رایگان ماهانه در ماه لذت ببرید. برای تغییر حساب صورتحساب پروژه خود:

  1. یک حساب صورت‌حساب جدید ایجاد کنید (اگر قبلاً یک حساب صورت‌حساب دارید، می‌توانید از این مرحله رد شوید).
  2. حساب صورتحساب را با پروژه خود مرتبط کنید .
چرا محدودیت سهمیه من روی 1 درخواست در روز تنظیم شده است؟ چگونه می توانم این حد را افزایش دهم؟

اگر یک حساب صورت‌حساب ایجاد نکرده‌اید و به پروژه خود پیوست نکرده‌اید، APIهای پلتفرم Maps شما به ۱ درخواست در روز محدود می‌شوند. با ایجاد و پیوست کردن حساب صورتحساب می توانید سهمیه بالاتری دریافت کنید. برای انجام این کار، به شروع با پلتفرم نقشه های گوگل مراجعه کنید.

پس از ایجاد و پیوست یک حساب صورتحساب، محدودیت سهمیه روزانه شما حذف خواهد شد. می‌توانید برای جلوگیری از هزینه‌های غیرمنتظره، در کنسول Cloud، محدودیتی تعیین کنید.

من یک اخطار نقض صورت حساب دریافت کردم. چگونه این را حل کنم؟

شما این اعلان را دریافت کرده‌اید زیرا Google تشخیص داده است که حساب شما از چندین حساب صورت‌حساب استفاده می‌کند. این نقض شرایط Google است، همانطور که در شرایط خدمات پلتفرم Google Maps تعریف شده است. تحت این شرایط، ایجاد چندین حساب صورتحساب ممنوع است. برای کسب اطلاعات بیشتر، به سؤالات متداول نقض حساب صورت‌حساب مراجعه کنید.

از پلتفرم نقشه های گوگل استفاده کنید

از کدام کلیدها یا اعتبارنامه ها برای محصولات مختلف Maps استفاده کنم؟

هر بار که از محصولات پلتفرم Google Maps استفاده می کنید، باید یک کلید API برای تأیید درخواست خود اضافه کنید. پلتفرم نقشه های گوگل برای برنامه های اندروید، iOS یا وب و برای سرویس های وب HTTP در دسترس است.

کلید API:

  • یک کلید API یک شناسه منحصربه‌فرد است که با استفاده از کنسول Cloud ایجاد می‌کنید.
  • مثالی از بارگیری یک API با یک کلید: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

امضای دیجیتال:

  • امضای دیجیتال با استفاده از راز امضای URL که توسط Google به شما ارائه شده است، ایجاد می‌شود. امضای دیجیتال با Maps Static API و Street View Static API استفاده می شود.

محدودیت ها:

  • محدودیت‌های کلید API اختیاری هستند، اما ما قویاً توصیه می‌کنیم تمام کلیدهای API را برای امنیت بیشتر محدود کنید. برای جزئیات بیشتر به بهترین شیوه های امنیتی API مراجعه کنید.
  • می توانید یک محدودیت برنامه را به کلید API اضافه کنید. پس از محدود شدن، یک کلید فقط روی پلتفرم هایی کار می کند که از آن نوع محدودیت پشتیبانی می کنند. چهار نوع محدودیت برنامه موجود است. APIهایی که یک نوع محدودیت را اعمال می کنند می توانند از همان کلید محدود استفاده کنند.
    • آدرس های IP (سرورهای فردی) - برای استفاده با API های سرویس وب .
    • ارجاع دهنده های HTTP (وب سایت ها) - برای استفاده با API های وب .
    • محدودیت برنامه Android (بر اساس نام بسته و اثر انگشت) - برای استفاده با Maps SDK برای Android .
    • محدودیت برنامه iOS (توسط شناسه بسته iOS) - برای استفاده با Maps SDK برای iOS .
  • همچنین می توانید یک محدودیت API به کلید API اضافه کنید. برای اطلاعات بیشتر، به دریافت، افزودن و محدود کردن یک کلید API مراجعه کنید.

جدول زیر کلید / اعتبار و محدودیت برنامه را برای هر API/SDK پلتفرم Google Maps نشان می‌دهد.

API/SDK اعتبارنامه و محدودیت درخواست
Maps SDK برای اندروید کلید API با محدودیت اندروید 1
مکان‌های SDK برای Android کلید API با محدودیت اندروید 1
Navigation SDK برای اندروید کلید API با محدودیت اندروید 1
Maps SDK برای iOS کلید API با محدودیت iOS 1
مکان‌های SDK برای iOS کلید API با محدودیت iOS 1
Navigation SDK برای iOS کلید API با محدودیت iOS 1
Maps JavaScript API کلید API با محدودیت ارجاع HTTP 1
Map Tiles API کلید API با محدودیت آدرس IP 1
Maps Datasets API نشانه OAuth
Aerial View API کلید API با محدودیت آدرس IP 1
Maps Static API کلید API با محدودیت ارجاع HTTP 1 + امضای دیجیتال 2
API استاتیک نمای خیابان کلید API با محدودیت ارجاع HTTP 1 + امضای دیجیتال 2
Maps Embed API کلید API با محدودیت ارجاع HTTP 1
Address Validation API کلید API با محدودیت آدرس IP 1
Elevation API کلید API با محدودیت آدرس IP 1
API کدگذاری جغرافیایی کلید API با محدودیت آدرس IP 1
API مکان جغرافیایی کلید API با محدودیت آدرس IP 1
Places API کلید API با محدودیت آدرس IP 1
Roads API کلید API با محدودیت آدرس IP 1
Routes API کلید API با محدودیت آدرس IP 1
API منطقه زمانی کلید API با محدودیت آدرس IP 1
API کیفیت هوا کلید API با محدودیت آدرس IP 1
Pollen API کلید API با محدودیت آدرس IP 1
API خورشیدی کلید API با محدودیت آدرس IP 1
1 محدودیت های کلید API اختیاری است، اما ما قویاً توصیه می کنیم برای امنیت بیشتر، همه کلیدهای API را محدود کنید.
2 بسته به نوع استفاده، ممکن است برای Maps Static API و Street View Static API به امضای دیجیتال نیاز باشد. صرف نظر از استفاده، ما اکیداً توصیه می کنیم که از کلید API و امضای دیجیتال برای احراز هویت درخواست های خود استفاده کنید.
چگونه می توانم نوع محدودیت کلید خود را از یک ارجاع دهنده HTTP به یک محدودیت آدرس IP تغییر دهم؟

مهم: اگر از هر یک از APIهای سرویس وب با یک کلید API استفاده می‌کنید که دارای محدودیت‌های ارجاع است، درخواست‌های شما با این پیام خطا شکست می‌خورد: «کلیدهای API نمی‌توانند محدودیت‌های ارجاع‌دهنده داشته باشند وقتی با این API استفاده می‌شوند». باید به استفاده از کلید API با محدودیت آدرس IP تغییر دهید.

قبل از اینکه نوع محدودیت کلید API را از ارجاع دهنده HTTP به آدرس IP تغییر دهید، مطمئن شوید که همه APIهایی که از کلید API استفاده می کنند از نوع محدودیت IP پشتیبانی می کنند. APIهای یک نوع محدودیت می توانند از همان کلید محدود استفاده کنند. اگر نیاز به اعمال بیش از یک محدودیت دارید، یک کلید جداگانه با محدودیت مورد نیاز اضافه کنید. نحوه افزودن یک کلید API جدید را ببینید.

درباره محدودیت‌های کلیدی API مرتبط با محصولات پلتفرم Google Maps بیشتر بیاموزید.

برای تغییر کلید API با محدودیت ارجاع HTTP به محدودیت آدرس IP، موارد زیر را انجام دهید:

  1. به صفحه Credentials کنسول Cloud بروید.
  2. پروژه ای را انتخاب کنید که حاوی کلید API است که می خواهید ویرایش کنید.
  3. در صفحه Credentials ، از لیست کلیدهای API، نام کلید API را برای ویرایش جزئیات کلید انتخاب کنید.
  4. در قسمت Key limitation صفحه، «آدرس های IP (سرورهای وب، cron jobs و غیره)» را انتخاب کنید و آدرس های IP سرور مناسب را وارد کنید، سپس روی ذخیره کلیک کنید.
چگونه یک کلید API جدید دریافت کنم؟
به شروع با پلتفرم نقشه های Google مراجعه کنید.
چگونه می توانم تغییرات ایجاد شده در هر نسخه از APIهای Google Maps را پیدا کنم؟

اطلاعات تغییر نسخه برای بسیاری از Maps API در پیوندهای زیر موجود است:

همچنین می‌توانید بررسی کنید که در کدام نسخه از Google Maps Platform یک باگ خاص با استفاده از ردیاب مشکلات پلتفرم Google Maps معرفی و رفع شده است:

https://issuetracker.google.com/bookmark-groups/76561

چگونه می توانم پس از بارگیری صفحه، API را به صورت ناهمزمان در صفحه بارگذاری کنم؟

فقط پارامتر callback را هنگام بارگذاری API مشخص کنید. اطلاعات بیشتر و کد نمونه را می‌توانید در بخش شروع به کار از مستندات Maps JavaScript API بیابید.

چگونه می توانم محصولات Google Maps Platform را برای نمایش به زبانی غیر از انگلیسی دریافت کنم؟

به طور پیش‌فرض API تلاش می‌کند تا مناسب‌ترین زبان را بر اساس موقعیت مکانی کاربر یا تنظیمات مرورگر بارگیری کند. برخی از APIها به شما این امکان را می دهند که در هنگام درخواست، به صراحت یک زبان را تنظیم کنید. اطلاعات بیشتر در مورد نحوه تنظیم زبان در اسناد هر API موجود است:

زبان های پشتیبانی شده:

گوگل اغلب زبان های پشتیبانی شده را به روز می کند. این فهرست ممکن است جامع نباشد و ممکن است تغییر کند.

کد زبان زبان کد زبان زبان
af آفریقایی ja ژاپنی
مربع آلبانیایی kn کانادا
هستم آمهری kk قزاقستان
ar عربی کیلومتر خمر
هی ارمنی ko کره ای
az آذربایجانی کی قرقیزستان
اتحادیه اروپا باسکی اینجا لائوس
باشد بلاروسی lv لتونی
bn بنگالی آن لیتوانیایی
bs بوسنیایی mk مقدونی
bg بلغاری ام‌اس مالایی
من برمه ای میلی لیتر مالایایی
حدود کاتالان آقای مراتی
zh چینی دقیقه مغولی
zh-CN چینی (ساده شده) ne نپالی
zh-HK چینی (هنگ کنگ) نه نروژی
zh-TW چینی (سنتی) pl لهستانی
ساعت کروات pt پرتغالی
cs چک pt-BR پرتغالی (برزیل)
دا دانمارکی pt-PT پرتغالی (پرتغال)
nl هلندی pa پنجابی
en انگلیسی ro رومانیایی
en-AU انگلیسی (استرالیایی) ru روسی
en-GB انگلیسی (بریتانیا کبیر) sr صربی
et استونیایی سی سینهالی
فا فارسی sk اسلواکی
فی فنلاندی sl اسلوونیایی
فایل فیلیپینی es اسپانیایی
fr فرانسوی es-419 اسپانیایی (آمریکای لاتین)
fr-CA فرانسوی (کانادا) sw سواحیلی
gl گالیسیایی sv سوئدی
کا گرجی تا تامیل
de آلمانی شما تلوگو
el یونانی هفتم تایلندی
گو گجراتی tr ترکی
iw عبری انگلستان اوکراینی
سلام هندی ur اردو
هو مجارستانی uz ازبکستان
است ایسلندی vi ویتنامی
شناسه اندونزیایی zu زولو
آن را ایتالیایی

می توانید ببینید که نقشه در هر یک از زبان های ذکر شده در بالا در این نمونه برنامه چگونه خواهد بود.

آیا می توان از طریق HTTPS (TLS) به پلتفرم نقشه های گوگل دسترسی داشت؟

همه پلتفرم های نقشه های گوگل می توانند و باید از طریق HTTPS قابل دسترسی باشند. برای اثبات برنامه های خود در آینده، ما قویاً توصیه می کنیم از TLS 1.3 برای HTTPS استفاده کنید. اگرچه نسخه‌های قدیمی‌تر TLS هنوز پشتیبانی می‌شوند، توصیه می‌کنیم به نسخه‌های قدیمی TLS قدیمی 1.0 و 1.1 اعتماد نکنید.

پروتکل SSL منسوخ دیگر پشتیبانی نمی شود.

برای اطلاعات بیشتر، سؤالات متداول مهاجرت CA ریشه پلتفرم Google Maps و سؤالات متداول Google Trust Services را ببینید.

چگونه می توانم یک اشکال را گزارش کنم یا یک ویژگی جدید را در پلتفرم Google Maps درخواست کنم؟

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

اگر می‌خواهید یک ویژگی را درخواست کنید، ابتدا آن را در انجمن مربوطه مطرح کنید تا تأیید کنید که راه‌حلی که نیازهای شما را برآورده می‌کند از قبل در دسترس نیست.

هنگامی که تأیید کردید که یک اشکال جدید شناسایی کرده‌اید، یا نیازهای شما توسط عملکرد موجود محصولات پلتفرم Google Maps برآورده نمی‌شود، اشکال یا درخواست ویژگی خود را با استفاده از ردیاب مشکلات پلتفرم Google Maps گزارش دهید.

قبل از افزودن یک اشکال یا درخواست ویژگی به ردیاب مشکل، مطمئن شوید که اشکال یا ویژگی مربوطه قبلاً اضافه نشده است. در صورت وجود، می توانید موضوع را ستاره دار کنید تا علاقه خود را ثبت کنید و از به روز رسانی ها مطلع شوید.

چگونه API های پلتفرم نقشه های گوگل از کوکی های سایت استفاده می کنند؟

Maps SDK برای Android و Maps SDK برای iOS از کوکی‌های مشمول خط‌مشی رازداری Google استفاده می‌کنند، مانند محاسبه کاربران فعال روزانه و ۷ روزه و جلوگیری از سوء استفاده از خدمات. این کوکی‌ها با هیچ حساب Google وارد شده مرتبط نیستند و با بقیه اطلاعات جمع‌آوری‌شده از تماس‌های API ثبت نمی‌شوند.

من نمی توانم پاسخ سوال خود را پیدا کنم. با چه کسی تماس بگیرم؟

تیم روابط توسعه‌دهنده Google در Stack Overflow حضور دارد - یک سایت پرسش و پاسخ با همکاری برنامه‌نویسان. این یک مکان عالی برای پرسیدن سوالات فنی در مورد توسعه و نگهداری برنامه های کاربردی Google Maps است. اطلاعات بیشتر در مورد سوال پرسیدن در Stack Overflow در صفحه پشتیبانی موجود است.

برای بهترین نتایج هنگام درخواست کمک، موارد زیر را در نظر داشته باشید:

  • بحث های جاری را جستجو کنید. به احتمال زیاد شخص دیگری مشکل مشابهی را تجربه کرده و راه حلی برای آن پیدا کرده است.
  • در صورت امکان لینک سایت خود را ارسال کنید. فقط در صورتی که کد به صورت آنلاین قابل مشاهده نباشد، تکه کد پست کنید.
  • تمام اطلاعات مرتبط از جمله نسخه های مرورگر، خطاها، و همه حقایق دیگر را که ممکن است در عیب یابی این مشکل مفید باشد، ارائه دهید.

خطاها و عیب یابی

این خطا به چه معناست؟

اگر هنگام بارگیری یا اجرای Google Maps API با خطا مواجه شدید، برای یافتن توضیحات کدهای خطا، به پیوندهای زیر مراجعه کنید:

نقشه های من تیره تر از حد معمول به نظر می رسند. چه اتفاقی می افتد؟

تحت شرایط خاص، ممکن است یک نقشه تاریک یا تصویر "منفی" نمای خیابان، با متن "فقط برای اهداف توسعه" نشان داده شود. این رفتار معمولاً مشکلات مربوط به کلید API یا صورت‌حساب را نشان می‌دهد. برای استفاده از محصولات پلتفرم Google Maps، باید یک حساب صورت‌حساب داشته باشید و همه درخواست‌ها باید دارای یک کلید API معتبر باشند. جریان زیر به رفع مشکل کمک می کند:

یک کلید API به عنوان پارامتر key در URL که برای بارگیری Maps JavaScript API استفاده می‌شود، ارسال می‌شود. در اینجا چند گزینه برای بررسی اینکه آیا از کلید API استفاده می کنید وجود دارد:

  • از افزونه Google Maps Platform API Checker Chrome استفاده کنید. این به شما امکان می دهد تعیین کنید که آیا وب سایت شما به درستی API های دارای مجوز Google Maps را پیاده سازی می کند یا خیر.
  • اگر از کتابخانه یا افزونه ای برای بارگیری Maps JavaScript API استفاده می کنید، تنظیمات مربوط به آن کتابخانه را بررسی کنید و به دنبال گزینه کلید API بگردید.
  • خطاهای مرورگر خود را بررسی کنید. اگر پیام های زیر را مشاهده کردید، از کلید API خود به درستی استفاده نمی کنید:

برای توسعه دهندگان وب:

  • اگر به کد منبع برنامه خود دسترسی دارید، به دنبال تگ <script> باشید که برای بارگیری Maps JavaScript API استفاده می شود. هنگام بارگیری Maps JavaScript API، YOUR_API_KEY در کد زیر را با کلید API خود جایگزین کنید. 
      <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
  • ترافیک شبکه ایجاد شده توسط وب سایت خود را در مرورگر بررسی کنید. در کروم، این مورد را می توان با استفاده از تب DevTools Network مشاهده کرد. در اینجا درخواست های شبکه ای را که توسط وب سایت خود ارائه شده است مشاهده خواهید کرد. درخواست‌های ارسال شده با استفاده از Maps JavaScript API در مسیر maps/api/js قرار خواهند گرفت. در اینجا می توانید تأیید کنید که آیا درخواست ها از پارامتر key استفاده می کنند. فیلتر کردن ترافیک شبکه بر اساس maps/api/js هنگام مشاهده برگه Network ممکن است مفید باشد.

برای دریافت کلید API، روی دکمه زیر کلیک کنید. اگر راه‌اندازی هدایت‌شده را نمی‌بینید، دستورالعمل‌های کامل را در «شروع با پلتفرم Google Maps» دنبال کنید.
شروع کنید

عالیه بیایید ادامه دهیم و بررسی کنیم که آیا یک حساب صورتحساب به پروژه شما متصل است یا خیر.

به صفحه صورتحساب در کنسول Google Cloud بروید و پروژه ای را که بر اساس آن کلید API شما ایجاد شده است انتخاب کنید. برای تأیید اینکه کلید با پروژه مرتبط است:

  1. به بخش Credentials بروید، که از نوار سمت چپ زیر Google Maps Platform > Credentials قابل دسترسی است.
  2. بررسی کنید که کلید API که در حال حاضر در وب‌سایت خود استفاده می‌کنید فهرست شده باشد. اگر اینطور نیست، به پروژه دیگری بروید و اعتبار را در آنجا بررسی کنید.
  3. اگر نمی توانید پروژه را برای کلید API خود پیدا کنید، ممکن است دسترسی به این پروژه را از دست داده باشید. از دیگران در سازمان خود کمک بخواهید. اگر پروژه اصلی نمی تواند مکان یابی شود، باید:
    1. یک پروژه جدید ایجاد کنید. این کار را می توان با انتخاب پروژه جدید از لیست پروژه ها یا با انتخاب ایجاد پروژه از طریق صفحه مدیریت منابع انجام داد.
    2. یک کلید API جدید ایجاد کنید. این کار را می توان در صفحه اعتبارنامه انجام داد. پس از آن روی Create credentials کلیک کنید و سپس کلید API را انتخاب کنید.

هنگامی که پروژه خود را در کنسول Cloud قرار دادید، با رفتن به بخش صورت‌حساب در منوی سمت چپ، بررسی کنید که آیا یک حساب صورت‌حساب ضمیمه شده است.

به صفحه فعال کردن صورتحساب در کنسول Cloud بروید و یک حساب صورتحساب به پروژه خود اضافه کنید. برای اطلاعات بیشتر، شروع به کار با Google Maps Platform را ببینید.

عالیه بیایید مطمئن شویم روش صورتحساب ارائه شده معتبر است.

می‌توانید یک روش پرداخت را در کنسول Cloud اضافه، حذف یا به‌روزرسانی کنید .

اگر محدودیت روزانه برای هر یک از API های خود تعیین کرده اید، که برای جلوگیری از افزایش غیرمنتظره معمول است، می توانید با افزایش محدودیت روزانه خود، این مشکل را حل کنید.

می توانید محدودیت های روزانه خود را با رفتن به داشبورد APIs & Services در کنسول Cloud بررسی کنید. یک بار آنجا:

  1. در صورت درخواست، پروژه ای را انتخاب کنید.
  2. یک API را از لیست انتخاب کنید، سپس روی برگه Quotas کلیک کنید.

کلیدهای API با محدودیت آدرس‌های IP را فقط می‌توان با سرویس‌های وب استفاده کرد که برای استفاده از سمت سرور در نظر گرفته شده‌اند (مانند API Geocoding و سایر APIهای وب سرویس ). اکثر این سرویس‌های وب دارای سرویس‌های معادل در Maps JavaScript API هستند (به عنوان مثال، سرویس کدگذاری جغرافیایی را ببینید). برای استفاده از خدمات سمت سرویس گیرنده Maps JavaScript API، باید یک کلید API جداگانه ایجاد کنید که می تواند با محدودیت ارجاع دهنده HTTP ایمن شود (به دریافت، افزودن و محدود کردن یک کلید API مراجعه کنید).


چگونه کدهای خطا را برطرف کنم: OVER_DAILY_LIMIT یا OVER_QUERY_LIMIT ؟
این کدهای خطا به هر یک از دلایل زیر قابل بازگشت هستند:

برای استفاده از محصولات پلتفرم Google Maps، باید یک حساب صورت‌حساب داشته باشید و همه درخواست‌ها باید دارای یک کلید API معتبر باشند. برای رفع این مشکل، مراحل زیر را انجام دهید:

چگونه کدهای خطا را حل کنم: kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED ؟
اگر kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED را مشاهده می کنید، ممکن است از نسخه منسوخ شده Places SDK برای Android یا Places SDK برای iOS استفاده کنید. بیشتر بیاموزید و SDK های جدید را در https://goo.gle/places-sdk-deprecation بیابید.
چگونه خطا را برطرف کنم: "این IP، سایت یا برنامه تلفن همراه مجاز به استفاده از این کلید API نیست."؟

سناریوهای مختلفی وجود دارد که ممکن است باعث ایجاد این خطا شود:

  • شما محدودیت‌های آدرس IP (سرور) را در کلید API خود فعال کرده‌اید، و یک آدرس IP غیرمجاز در حال تلاش برای درخواست است.
  • شما محدودیت های ارجاع دهنده (وب سایت) HTTP را در کلید API خود فعال کرده اید، و یک ارجاع دهنده غیرمجاز در حال تلاش برای درخواست است.
  • شما با تنظیم نام بسته و اثر انگشت استفاده را به برنامه‌های Android خود محدود کرده‌اید و یک برنامه Android غیرمجاز در حال تلاش برای درخواست است.
  • شما درخواست‌های برنامه‌های iOS را با تعیین شناسه‌های بسته محدود کرده‌اید و یک برنامه iOS ناشناس در حال تلاش برای ارسال درخواست است.
  • اگر از هر یک از API های سرویس وب با یک کلید API با محدودیت های ارجاع HTTP استفاده می کردید، ممکن بود این خطا را دریافت کنید. درخواست‌ها به آن APIها باید با یک کلید API با محدودیت‌های آدرس IP شناسایی شوند. نوع محدودیت کلید خود را از یک محدودیت ارجاع دهنده HTTP به یک محدودیت آدرس IP تغییر دهید . برای اطلاعات بیشتر در مورد محدود کردن کلیدهای API، به بهترین روش‌های کلیدی API مراجعه کنید.

مشخصات کلید API خود را مشاهده و ویرایش کنید

برای مشاهده کلیدهای API خود و مدیریت هرگونه محدودیت، موارد زیر را انجام دهید:

  1. به صفحه Credentials کنسول Cloud بروید.
  2. پروژه ای را انتخاب کنید که حاوی کلید API است که می خواهید بررسی کنید.
  3. برای مشاهده جزئیات اعتبار، از جمله هرگونه محدودیت تعیین شده برای کلید، از لیست کلیدهای API، روی نام کلید کلیک کنید.
  4. اطلاعات کامل کلید API انتخاب شده، از جمله هرگونه محدودیت تنظیم شده برای کلید، نمایش داده می شود. از اینجا، محدودیت ها می توانند در صورت نیاز تغییر، حذف یا به روز شوند.
چگونه این خطا را حل کنم: "کلیدهای API با محدودیت های ارجاع دهنده نمی توانند با این API استفاده شوند."؟

شما از هر یک از APIهای سرویس وب با یک کلید API محدود به ارجاع دهنده HTTP استفاده می کنید. به دلایل امنیتی، APIهای سرویس وب باید از کلیدهای API محدود به آدرس‌های IP استفاده کنند. نوع محدودیت کلید خود را از محدودیت ارجاع دهنده HTTP به محدودیت آدرس IP تغییر دهید ، یا اگر کلید شما قبلاً با Maps JavaScript API استفاده شده است، یک کلید API جدید ایجاد کنید.

خدمات پلتفرم نقشه های گوگل

من باید آدرس ها را به جفت طول و عرض جغرافیایی تبدیل کنم. آیا می توانم این کار را با پلتفرم نقشه های گوگل انجام دهم؟

بله، این فرآیند "ژئوکدینگ" نامیده می شود. Maps JavaScript API شامل یک کلاس برای انجام یک سرویس کدگذاری جغرافیایی است. کلاس این است: google.maps.geocoder .

از طرف دیگر، Google API Geocoding را نیز ارائه می‌کند که یک رابط REST ارائه می‌دهد که می‌تواند در قالب‌های JSON و XML پاسخ دهد.

ژئوکدینگ در کدام کشورها موجود است؟

برای مشاهده کشورهایی که توسط geocoders پلتفرم Google Maps پشتیبانی می‌شوند، به داده‌های پوشش Google Maps مراجعه کنید.

دقت مکان‌های کدگذاری‌شده جغرافیایی ممکن است در هر کشور متفاوت باشد، بنابراین باید از فیلد location_type برگشتی استفاده کنید تا تعیین کنید آیا مطابقت کافی برای اهداف برنامه شما پیدا شده است یا خیر. در دسترس بودن داده های کدگذاری جغرافیایی به قراردادهای ما با ارائه دهندگان داده بستگی دارد، بنابراین ممکن است تغییر کند.

چرا ژئوکدرهای پلتفرم نقشه های گوگل مکان های متفاوتی نسبت به نقشه های گوگل ارائه می دهند؟

geocoder API و geocoder Google Maps گاهی اوقات از مجموعه داده های متفاوتی (بسته به کشور) استفاده می کنند. geocoder API گاهی اوقات با داده های جدید به روز می شود، بنابراین می توانید انتظار داشته باشید که نتایج در طول زمان تغییر یا بهبود یابد.

چگونه باید پرس و جوهای ژئوکدر خود را قالب بندی کنم تا تعداد درخواست های موفق را به حداکثر برسانم؟

ژئوکدر طراحی شده است تا آدرس خیابان ها را به مختصات جغرافیایی نشان دهد. بنابراین توصیه می‌کنیم درخواست‌های ژئوکددر را مطابق با دستورالعمل‌های زیر قالب‌بندی کنید تا احتمال یک پرس و جو موفقیت‌آمیز را به حداکثر برسانید:

  • آدرس ها را مطابق با فرمت استفاده شده توسط سرویس ملی پستی کشور مورد نظر مشخص کنید.
  • عناصر آدرس اضافی مانند نام تجاری ، شماره واحد ، شماره کف یا شماره مجموعه را که در آدرس موجود نیست ، مطابق با سرویس پستی کشور مورد نظر مشخص نکنید. انجام این کار ممکن است منجر به پاسخ با ZERO_RESULTS شود.
  • قالب به علاوه کدهای همانطور که در اینجا نشان داده شده است (به علاوه علائم URL به %2B تبدیل شده و فضاها URL به %20 تبدیل شده اند):
    • کد جهانی یک کد منطقه 4 کاراکتر و 6 کاراکتر یا کد محلی طولانی تر است (849VCWC8+R9 849VCWC8%2BR9 است).
    • کد مرکب یک کد 6 کاراکتر یا طولانی تر با مکان صریح است (CWC8+R9 Mountain View ، CA ، USA CWC8%2BR9%20Mountain%20View%20CA%20USA ) است.
  • در صورت امکان از شماره خیابان یک فرضیه استفاده کنید.
  • در اولویت برای مشخص کردن خیابان های صلیب در صورت امکان از آدرس شماره خیابان استفاده کنید.
  • "نکات" مانند نقاط دیدنی در نزدیکی را ارائه ندهید.
چگونه باید یک آدرس ایالات متحده را در یک بزرگراه شماره گذاری شده برای کدگذاری جغرافیایی فرمت کنم؟

Google Maps Platform GeoCoder نیاز دارد که بزرگراه های شماره گذاری شده ایالات متحده در آدرس ها به شرح زیر مشخص شود:

  • جاده های شهرستان: "Co Road NNN " که NNN شماره جاده است. به عنوان مثال "Co Road 82"
  • بزرگراه های ایالتی: " State NNN " که در آن ایالت نام کامل دولت است و NNN شماره بزرگراه است. به عنوان مثال "California 82"
  • بزرگراه های ایالات متحده: "US NNN " که در آن شماره بزرگراه است. به عنوان مثال "US 101"
  • Interstates ایالات متحده: "Interstate NNN " که NNN شماره بین المللی است. به عنوان مثال "Interstate 280"
چه موقع باید از کلاس GeoCoder API استفاده کنم و چه زمانی باید از سرویس GeoCoding HTTP استفاده کنم؟

به سند مراجعه کنید: استراتژی های GeoCoding ، که جزئیات و محدودیت های استراتژی های مختلف جغرافیایی را شرح می دهد.

چگونه می توانم مسیرهای رانندگی را با پلت فرم Google Maps ارائه دهم؟

سرویس محاسبات مسیرهای API به شما امکان می دهد مسیرهای رانندگی را برای سفرهای یک و چند پا ارائه دهید. گزینه های مسیریابی به شما کمک می کند تا با یک حالت مسافرتی (رانندگی) ، یک یا مجموعه ای از مسیرها و محدودیت ها (بدون جاده عوارض) جهت ها را شکل دهید. این سرویس ها به اشکال زیر در دسترس هستند:

رابط درخواست/پاسخ HTTP (استفاده شده در موبایل و سایر برنامه ها) با نقشه SDK برای Android و سایر خدمات وب Google Maps سازگار است.

مسیرهای رانندگی در کدام کشورها موجود است؟

برای دیدن کشورهایی که با استفاده از مسیرهای رانندگی در Google Maps Platform Products پشتیبانی می شوند ، با داده های پوشش Google Maps مشورت کنید. در دسترس بودن داده های جهت رانندگی به قراردادهای ما با ارائه دهندگان داده بستگی دارد و در معرض تغییر است.

مسیرهای ترانزیت در کدام کشورها موجود است؟

API Routes از همه شرکای Google Transit پشتیبانی می کند ، به جز شرکت پذیرایی و گردشگری راه آهن هند و شرکت های ژاپن.

کدام ویژگی های KML و Georss در نقشه های API JavaScript پشتیبانی می شوند؟

کلاس Kmllayer در نقشه های JavaScript API به توسعه دهندگان این امکان را می دهد تا پرونده های KML/KMZ و Georss را در بالای نقشه پوشش دهند. برای اسناد و نمونه ها ، به کلاس Kmllayer مراجعه کنید.

محدودیت های اندازه و پیچیدگی KML که می تواند با استفاده از کلاس Kmllayer از نقشه های JavaScript API نمایش داده شود چیست؟

اندازه و محدودیت پیچیدگی در نمایش KML با استفاده از کلاس KmlLayer ، نمای کلی Kmllayer ثبت شده است.

چگونه می توانم پرونده های KML را که در سایت های اینترانت میزبان هستند ، ارائه دهم؟

کلاس KmlLayer که در نقشه های JavaScript API پوشش KML ایجاد می کند ، از یک سرویس میزبان Google برای بازیابی و تجزیه پرونده های KML برای ارائه استفاده می کند. در نتیجه ، نمایش پرونده های KML که در URL میزبانی نشده اند که در دسترس عموم باشد ، یا نیاز به تأیید اعتبار برای دسترسی ندارد ، امکان پذیر نیست.

در صورت نیاز به توسعه برنامه هایی که از پرونده های KML میزبان در سایت های اینترانت استفاده می کنند ، توصیه می کنیم KML را با استفاده از کتابخانه های جاوا اسکریپت شخص ثالث در سمت مشتری ارائه دهید. از آنجا که پرونده KML توسط مرورگر مورد تجزیه و تحلیل قرار می گیرد ، ممکن است عملکرد با استفاده از کلاس KmlLayer کمتر باشد.

حداکثر تعداد نشانگرها یا رئوس مسیرهای پشتیبانی شده توسط Maps Static API چقدر است؟

هیچ محدودیتی برای تعداد نشانگرها یا راس های مسیر پشتیبانی شده توسط API استاتیک نقشه ها وجود ندارد. هنگام استفاده از نمادهای سفارشی ، حداکثر پنج نماد منحصر به فرد در هر درخواست قابل مشخص است ، اما هر یک از آنها می تواند چندین بار در نقشه استفاده شود.

توجه داشته باشید که URL های API استاتیک نقشه ها می توانند حداکثر تقریباً 8192 کاراکتر را شامل شوند که تعداد نشانگرها و راس های مسیر را محدود می کند که می توانند بر اساس تعداد مکان های اعشاری مورد استفاده در هنگام مشخص کردن هر جفت عرض جغرافیایی مشخص شوند. برای کسب اطلاعات در مورد چگونگی ارتباط تعداد اعشاری مورد استفاده با صحت روی زمین ، به مقاله ویکی پدیا در مورد درجه های اعشاری مراجعه کنید.

چرا نمی توانم برای کشورهای خاص به محصولات پلت فرم Google Maps دسترسی پیدا کنم؟

API MAPS ممکن است در سرزمین های ممنوعه استفاده نشود. همچنین به شرایط خدمات مراجعه کنید.

چگونه می توانم مشکلی را در پایه Google گزارش کنم؟
ارسال بازخورد از طریق نقشه های Google برای اطلاعات اشتباه یا گمشده نقشه مانند:
  • آدرس های اشتباه یا مکان های نشانگر
  • نام های جاده ای نادرست
  • اطلاعات اشتباه در مورد جاده های یک طرفه و دو طرفه
  • جاده نادرست کشیده شده
  • جاده های بسته
  • جاده هایی که وجود ندارند

برای تصحیح یک مکان یا لیست مشاغل ، ویرایش را پیشنهاد دهید .

اگر باید به دلایل قانونی محتوا حذف شود ، درخواست قانونی ارسال کنید.

برای درخواست های حساس یا حساس به زمان ، یک مورد پشتیبانی را با جزئیات خاص در مورد آنچه باید برطرف شود ، تشکیل دهید.

چگونه عملکرد سرویس‌های مورد استفاده با Maps JavaScript API نظارت می‌شود؟

برخی از ویژگی های سمت مشتری برای گزارش موفقیت یا عدم موفقیت به منظور محاسبه SLO (هدف سطح خدمات) استفاده شده است. این اطلاعات در maps.googleapis.com/maps_api_js_slo/log در تماس هایی که اطلاعات SLO را وارد می کنند ، به Google ارسال می شود. این اطلاعات شامل وضعیت موفقیت ، تأخیر و نسخه/کانال نقشه های API JavaScript در حال استفاده است. تماس ها ممکن است برای عملکرد انجام شود. ممکن است لازم باشد که در خط مشی امنیت محتوای خود maps.googleapis.com اجازه دهید تا اطمینان حاصل شود که این تماس ها در سطح مرورگر مسدود نشده است. به عنوان مثال: Content-Security-Policy: default-src 'self' maps.googleapis.com; با هدرهای HTTP ، یا <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> با برچسب های متا HTML.

Maps JavaScript API

نقشه های JavaScript API پس از بارگیری چه مدت کار می کنند؟

شما باید صفحه ای را که حداقل یک بار 5 روز یک بار نقشه های JavaScript را بارگیری می کند ، تازه کنید.

Google Maps SDK برای iOS

چگونه خطا را حل کنم: kGMSPlacesRateLimitExceeded ؟
اگر این خطا را مشاهده می کنید ، ممکن است از نسخه مستهجن مکان های SDK برای iOS استفاده کنید. نسخه 2.7.0 از مکان های SDK برای iOS خاموش شده است و دیگر در دسترس نیست. برنامه خود را به روز کنید تا در اسرع وقت از آخرین نسخه استفاده کنید. برای جزئیات بیشتر به راهنمای مهاجرت مراجعه کنید.
هنگام اشکال زدایی با دستگاه iOS 8.x ، تصادف می کنم. چه کار کنم؟

اگر هنگام اشکال زدایی با دستگاه هایی که iOS 8.x را اجرا می کنند ، مشکلی را تجربه می کنید ، این مراحل را دنبال کنید تا ضبط قاب GPU را در طرح XCODE که در حال اجرا هستید غیرفعال کنید:

  1. در Xcode ، محصول ، طرح ، مدیریت طرح ها را انتخاب کنید.
  2. یک طرح را انتخاب کنید و ویرایش را انتخاب کنید ...
  3. گزینه GPU Frame Capture را روی Disabled تنظیم کنید. توجه داشته باشید که این گزینه ممکن است برای همه دستگاه ها وجود نداشته باشد.
گزینه ضبط قاب XCode در صفحه دستگاه iOS عمومی
تأثیر صفحه نمایش های گرد و گسترده تر در Google Maps iOS SDK چیست؟

با شروع آیفون X ، آیفون ها دارای شکل صفحه نمایش هستند که دارای گوشه های گرد ، شکاف در قسمت بالا برای محفظه سنسور دستگاه و یک نشانگر در پایین صفحه برای دسترسی به صفحه اصلی است. از نظر iOS 11.0 SDK ، اپل API منطقه امن را اضافه کرد و به توسعه دهندگان این امکان را می دهد تا عناصر را در منطقه ای قرار دهند که از شکل صفحه نمایش جدید در امان باشد.

Google Maps IOS SDK دارای عناصر و کنترل های بصری بسیاری است ، مانند یک انتخاب کننده داخلی و گزارش پیوند مشکل. با نسخه 2.4 ، این عناصر و کنترل های بصری می توانند با شکل صفحه نمایش جدید قطع شوند. در حالت چشم انداز ، انتخاب کننده کفپوش داخلی ممکن است توسط شکاف یا نشانگر دکمه خانه قطع شود.

با انتشار نسخه های Google Maps IOS SDK 2.5 ، این مشکلات طرح بندی به طور خودکار برطرف می شود. هنگامی که برنامه شما در آیفون X یا بعد از آن استفاده می شود ، بالشتک در GMSmapView و Gmspanoramaview افزایش می یابد تا عناصر بصری قطع نشوند.

به طور پیش فرض ، ما همیشه بالشتک شما را در بر می گیریم. Google Maps IOS SDK فرض می کند که بالشتک در نظر گرفته شده است که از داخل منطقه امن استفاده کند. اگر رابط کاربری خود را با این فرض طراحی کنید که همه چیز در منطقه امن قرار گرفته است ، این کار بدون هیچ تلاش اضافی کار خواهد کرد.

اگر رابط کاربری طراحی کرده اید که با تنظیم پیش فرض ما کار نمی کند ، ما یک ویژگی جدید را به GMSmapview با نام PaddingAdustmentBehavior معرفی کرده ایم. GMSmapView اکنون به شما امکان می دهد یکی از سه رفتار تنظیمات تنظیمات را انتخاب کنید: "همیشه" (پیش فرض) ، "اتوماتیک" و "هرگز".

اگر قرار است GmsMapView از رفتار "همیشه" استفاده کند ، همیشه قسمت های امن منطقه را به بالشتک اضافه می کند. این تنظیم به شما امکان می دهد رابط خود را با این فرض که تمام محل قرارگیری از لبه های منطقه امن است ، طراحی کنید. این مقدار پیش فرض است.

اگر GmsMapView از رفتار بالشتک "اتوماتیک" استفاده کند ، همیشه بزرگتر از بالشتک یا قسمت امن منطقه را انتخاب می کند. این تنظیم به شما امکان می دهد تا در حالی که همیشه اطمینان حاصل کنید که همه عناصر در منطقه امن باقی می مانند ، بالشتک را از لبه صفحه اضافه کنید.

اگر قرار است GmsMapView از رفتار "هرگز" استفاده کند ، هرگز به قسمت های امن منطقه ایمن به بالشتک اضافه نمی کند. این رفتار قبل از انتشار 2.5 است و اگر بالشتک شما از قبل منطقه امن را در نظر بگیرد ، یا اگر رفتارهای دیگر ما با رابط کاربری شما خوب عمل نمی کنند ، ممکن است مفید باشد. این وظیفه شماست که اطمینان حاصل کنید که آرم Google و اعلامیه های حق چاپ همیشه قابل مشاهده هستند ، همانطور که در شرایط خدمات پلت فرم Google Maps مشخص شده است.

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

Google Maps SDK برای Android

چگونه می توانم خطا را برطرف کنم: 9005 PLACES_API_RATE_LIMIT_EXCEEDED ؟
اگر این خطا را مشاهده می کنید ، ممکن است از یک نسخه مستهجن از مکان های SDK برای Android استفاده کنید. نسخه Google Play Services از مکان های SDK برای Android خاموش شده است و دیگر در دسترس نیست. برنامه خود را به روز کنید تا در اسرع وقت از آخرین نسخه استفاده کنید. برای جزئیات بیشتر به راهنمای مهاجرت مراجعه کنید.
برنامه من فقط کاشی های خاکستری خالی را به جای نقشه نشان می دهد. چگونه می توانم این را حل کنم؟

یک دلیل رایج که کاشی های خاکستری خالی به جای نقشه نشان داده می شود ، مشکلات احراز هویت است. می توانید مراحل زیر را برای عیب یابی این موارد با استفاده از ADB LogCat دنبال کنید.

  1. اطمینان حاصل کنید که ADB نصب شده است. اگر اینگونه نباشد ، می توانید راهنمای Android ADB را دنبال کنید.
  2. برنامه ای را که مشکل را در یک دستگاه یا یک شبیه ساز اندرویدی نشان می دهد نصب کنید. اگر از Android Emulator استفاده می کنید ، اطمینان حاصل کنید که تنظیمات شبیه ساز شامل فروشگاه Play است.
  3. در ترمینال Android Studio ، adb logcat -e "Google Maps Android API" را اجرا کنید. این فقط خطوطی را چاپ می کند که در آن پیام ورود به سیستم با "Google Maps Android API" مطابقت دارد (به صورت اختیاری ، می توانید با ضمیمه:> logcat.txt ورود به یک پرونده متنی را وارد کنید.
  4. مسئله را در دستگاه خود بازتولید کنید و خطاهای متداول مانند:
    • کلید API اشتباه/ناخواسته در مانیفست ارجاع می شود.
    • صورتحساب در پروژه فعال نیست.
    • SDK در API های پروژه فعال نیست.
    • اثر انگشت نادر SHA-1 به محدودیت های اصلی API اضافه می شود.
    • وابستگی های سرویس Google Play در پرونده build.gradle گنجانده نشده است.

امضای URL

آیا می توانم URL ها را با استفاده از JavaScript امضا کنم؟

ما اکیداً در مورد امضای URL با استفاده از JavaScript توصیه می کنیم زیرا این امر می تواند راز URL شما را برای کاربران نهایی در معرض نمایش قرار دهد. بنابراین امضاها فقط باید توسط اجزای جانبی سرور ایجاد شوند.

چرا یک پاسخ HTTP 403 Forbidden به درخواست‌های سرویس وب Maps API خود دریافت می‌کنم؟

پاسخ HTTP 403 نشانگر یک مسئله مجوز است ، به احتمال زیاد به دلیل اینکه امضای برای این درخواست قابل تأیید نیست. این می تواند به این دلیل باشد که:

  1. امضا مشخص شده است اما برای این درخواست نادرست است.
  2. این درخواست یک برنامه حق بیمه پلتفرم Google Maps یک کلید API را مشخص می کند اما امضای آن را مشخص نمی کند ، و این سرویس که خوانده می شود نیاز دارد که درخواست های انجام شده با استفاده از یک کلید API شامل یک امضای معتبر باشد.
  3. امضای مشخص شده است اما کلید API PLAN PLAM PLAMIUM PLATOM PLATOM PLATOM Google Associated مشخص نشده است.