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