«کارخواه Java»، «کارخواه Python»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویس‌های Google Maps» کتابخانه‌های کارخواه با پشتیبانی انجمن هستند که به‌عنوان منبع باز تحت پروانه Apache 2.0 منتشر شده‌اند. این کتابخانه‌ها برای بارگیری و مشارکت در GitHub دردسترس هستند، جایی که می‌توانید دستورالعمل‌های نصب و کد نمونه را نیز پیدا کنید:
- Java Client for Google Maps Services
- Python Client for Google Maps Services
- Go Client برای سرویس‌های Google Maps
- Node.js Client for Google Maps Services
چرا باید از کتابخانه‌های کارخواه استفاده کرد؟
«کارخواه Java»، «کارخواه Python»، «کارخواه Go»، و «کارخواه Node.js» برای «خدمات Google Maps» به شما امکان می‌دهند با خدمات وب Google Maps در سرورتان کار کنید. آن‌ها عملکرد میاناهای برنامه‌سازی کاربردی زیر را دربرمی‌گیرند:
- Address Validation API
- Directions API (Legacy)
- Distance Matrix API (Legacy)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API
علاوه‌بر عملکردی که این میاناهای برنامه‌سازی کاربردی ارائه می‌دهند، کتابخانه‌های کارخواه کارهای رایج را ساده می‌کنند:
- محدود کردن خودکار نرخ: درخواست‌ها را به‌طور پیش‌فرض با حد نرخ موردانتظار برای هر سرویس وب ارسال می‌کند. می‌توانید محدودیت‌های سفارشی برای تعداد پُرسمان در دقیقه (QPM) با
new GeoApiContext().setQueryRateLimit(qpm)ارائه دهید. - امتحان مجدد درصورت ناموفق بودن: وقتی API خطای سطح ۵۰۰ ارسال می‌کند، به‌طور خودکار هر درخواستی را دوباره امتحان می‌کند و از عقب‌گرد نمایی برای کمک به مدیریت خرابی‌های متناوب استفاده می‌کند.
- اصالت‌سنجی ساده: به شما امکان می‌دهد با کلید میانای برنامه‌سازی کاربردی، یا با شناسه کارخواه و رمز برای مشتریان طرح Google Maps Platform Premium اصالت‌سنجی کنید.
- اشیاء قدیمی ساده Java (POJO): اشیاء Java تایپ‌شده را برای هر پاسخ API در کتابخانه Java برمی‌گرداند، درحالی‌که کتابخانه Python ساختار پاسخ را مستقیماً از API برمی‌گرداند.
- تماس‌های ناهمگام یا همگام: از هر دو سبک تماس همگام و ناهمگام برای همه درخواست‌ها پشتیبانی می‌کند.
شروط خدمات
کتابخانه‌های کارخواه برای خدمات وب Google Maps تحت پروانه Apache 2.0 پروانه گرفته‌اند.
کتابخانه‌های کارخواه پوشش‌هایی برای خدمات وب Google Maps هستند که تحت کنترل شرایط خدمات Google Maps Platform هستند.
کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های کارخواه
هر سرویس وب Google Maps به کلید میانای برنامه‌سازی کاربردی یا شناسه کارخواه نیاز دارد. برای کسب اطلاعات بیشتر درباره اینکه چه زمانی از کلید میانای برنامه‌سازی کاربردی استفاده کنید، چه زمانی از شناسه کارخواه استفاده کنید، و چگونه کلید میانای برنامه‌سازی کاربردی یا شناسه کارخواه خود را دریافت کنید، راهنمای اصالت‌سنجی میانای برنامه‌سازی کاربردی را که استفاده می‌کنید ببینید:
- Address Validation API
- Directions API (Legacy)
- Distance Matrix API (Legacy)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API