این محصول در وضعیت قدیمی است. از اکتبر ۲۰۲۶، دیگر نمی‌توان Distance Matrix API (قدیمی) را برای پروژه‌های جدید Google Cloud فعال کرد. پروژه‌های موجود همچنان به‌طور کامل پشتیبانی می‌شوند. برای ویژگی‌های جدید و عملکرد بهبودیافته، به «میانای برنامه‌سازی کاربردی مسیرها» نقل مکان کنید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

خط‌مشی‌ها و ارجاع‌های Distance Matrix API (قدیمی)

این سند الزامات برنامه‌های توسعه‌یافته با Distance Matrix API (قدیمی) را فهرست می‌کند. توجه داشته باشید که استفاده از Distance Matrix API (قدیمی) تحت کنترل «قرارداد» شما با Google است.

خط‌مشی‌ها

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

استثنائات محدودیت‌های ذخیره کردن در حافظه نهان

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

کشورها و قلمروهای منطقه اقتصادی اروپا

این محصول برای مشتریانی که نشانی صورت‌حساب آن‌ها در منطقه اقتصادی اروپا (EEA) است «شرایط خدمات» متفاوتی دارد و ممکن است عملکرد متفاوتی نیز داشته باشد. قبل‌از ساختن با Google Maps Platform، شرایط و اطلاعات زیر را که مختص منطقه اقتصادی اروپا است مرور کنید:

اگر نشانی صورت‌حساب شما در منطقه اقتصادی اروپا نیست، شرایط خدمات زیر برای شما اعمال می‌شود:

الزامات ذکر منبع Google Maps

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

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

نمایش اسناد Google Maps

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

ارجاع Google Maps اضافه شد

برای اسناد Google Maps که قبلاً توسط «پلاتفرم Google Maps» در واسط کاربر ارائه شده است، مانند «کیت واسط کاربر مکان‌ها»:

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

نشان‌واره Google Maps و اسناد استنادی نوشتاری

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

ارجاع نشان‌واره

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

بارگیری نشان‌واره‌های Google Maps

از فایل‌های رسمی نشان‌واره Google Maps استفاده کنید. نشان‌واره‌های زیر را بارگیری کنید و دستورالعمل‌های این بخش را دنبال کنید.

دارایی‌های اسنادی Google Maps را بارگیری کنید

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

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

مشخصات اندازه نشان‌واره

مشخصات اندازه زیر را برای نشان‌واره Google Maps دنبال کنید:

حداقل ارتفاع نشان‌واره: ۱۶ پیکسل مستقل از تراکم
حداکثر ارتفاع نشان‌واره: ۱۹ پیکسل مستقل از تراکم
حداقل فضای خالی نشان‌واره: ۱۰ پیکسل مستقل از تراکم در چپ، راست، و بالا، ۵ پیکسل مستقل از تراکم در پایین

برای آشنایی با dp، به تراکم پیکسل در وب‌سایت Material Design مراجعه کنید.

دسترس‌پذیری نشان‌واره

این الزامات دسترس‌پذیری را برای نشان‌واره Google Maps دنبال کنید:

تضاد دسترس‌پذیری بین نشان‌واره و پس‌زمینه حفظ کنید.
برچسب دسترس‌پذیری را با نوشتار Google Maps اضافه کنید.

انتساب نوشتار

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

گونه‌های قابل‌قبول اسناد نوشتاری Google Maps — نمونه‌هایی از تغییرات قابل‌قبول نوشتار اسنادی Google Maps

به هیچ وجه نوشتار Google Maps را تغییر ندهید:
- حروف بزرگ و کوچک Google Maps را تغییر ندهید
- Google Maps را در چند خط نپیچید
- Google Maps را به زبان دیگری بومی‌سازی نکنید.
- بااستفاده از مشخصه HTML translate="no"، از ترجمه Google Maps توسط مرورگرها جلوگیری کنید.

انواع غیرقابل‌قبول ارجاع نوشتاری Google Maps — نمونه‌هایی از تغییرات غیرقابل‌قبول نوشتار اسنادی Google Maps

نوشتار Google Maps را به‌سبک شرح‌داده‌شده در جدول زیر بنویسید:

الزامات سبک‌دهی نوشتار Google Maps
دارایی	سبک
خانواده قلم	Roboto. بار کردن قلم اختیاری است.
خانواده قلم جایگزین	هر قلم سن‌سریف نوشتار اصلی که قبلاً در محصولتان استفاده شده است یا «سن‌سریف» برای فراخوانی قلم پیش‌فرض سیستم
سبک قلم	معمولی
ضخامت قلم	۴۰۰
رنگ قلم	سفید، سیاه (#1F1F1F)، یا خاکستری (#5E5E5E). کنتراست دسترس‌پذیر (۴.۵:۱) را درمقابل پس‌زمینه حفظ کنید.
اندازه قلم	حداقل اندازه قلم: ۱۲ اس‌پی حداکثر اندازه قلم: ۱۶ اس‌پی برای آشنایی با اس‌پی، واحدهای اندازه قلم را در وب‌سایت «طراحی مواد» ببینید.
فاصله حروف	معمولی

نمونه CSS

CSS زیر Google Maps را با سبک و رنگ تایپوگرافی مناسب در پس‌زمینه سفید یا روشن ارائه می‌کند.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

الزامات دیداری

این الزامات را برای پردازش تصویری اسناد استنادی Google Maps دنبال کنید.

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

تصاویر زیر نمونه‌هایی از این الزامات دیداری را نشان می‌دهد.

نمونه اسناد استنادی Google Maps که در بالا، پایین، و کنار محتوا قرار گرفته است — نمونه‌ای از اسناد استنادی Google Maps که در بالا، پایین، و کنار محتوا قرار گرفته است

مثالی از دو رویکرد برای متمایز کردن «محتوای Google Maps» (رده‌بندی مکان) از محتوای دیگر — نمونه‌ای از دو رویکرد برای متمایز کردن «محتوای Google Maps» (رده‌بندی مکان) از محتوای دیگر

اسناد Google Maps را مبهم نکنید یا آن را با محتوای منابع دیگر ترکیب نکنید — اسناد استنادی Google Maps را مبهم نکنید یا آن را با محتوای منابع دیگر ترکیب نکنید

ارائه‌دهندگان داده طرف سوم

برخی‌از داده‌ها و تصاویر در محصولات نقشه‌برداری ما از ارائه‌دهندگانی غیر از Google می‌آید. برای برخی محصولات، مانند Map Tiles API، ممکن است اسناد استنادی موردنیاز را به ارائه‌دهنده داده طرف سوم ارائه دهیم. وقتی این کار را انجام می‌دهیم، نوشتار اسناد باید نام «Google Maps» و ارائه‌دهنده(های) داده مربوطه، مثل «داده‌های نقشه: Google،‏ Maxar Technologies» را ذکر کند. وقتی Google اسناد استنادی طرف سوم ارائه می‌دهد، تنها شامل کردن «Google Maps» یا نشان‌واره Google استناد مناسب نیست.

خط‌مشی‌ها و ارجاع‌های Distance Matrix API (قدیمی) با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.