«کارخواه جاوا»، «کارخواه پایتون»، «کارخواه 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 (قدیمی)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API
علاوه‌بر عملکردی که این میاناهای برنامه‌سازی کاربردی ارائه می‌دهند، کتابخانه‌های کارخواه برخی‌از کارهای رایج را کمی آسان‌تر می‌کنند.
- محدود کردن خودکار نرخ به‌طور پیش‌فرض، درخواست‌ها با حد نرخ موردانتظار برای هر سرویس وب ارسال می‌شوند. می‌توانید محدودیت‌های سفارشی QPM را با
new GeoApiContext().setQueryRateLimit(qpm)ارائه دهید. - تلاش مجدد درصورت عدم موفقیت اگر API خطای
5xxارسال کند، کتابخانه‌های کارخواه به‌طور خودکار هر درخواستی را مجدداً امتحان می‌کنند. تلاش‌های مجدد از عقب‌گرد نمایی استفاده می‌کنند که درصورت بروز خطاهای متناوب کمک می‌کند. - اصالت‌سنجی آسان کتابخانه‌های کارخواه اصالت‌سنجی را با «کلید میانای برنامه‌سازی کاربردی» که به‌طور رایگان دردسترس است آسان می‌کند. مشتریان طرح Google Maps Platform Premium می‌توانند از شناسه کارخواه و رمز خود استفاده کنند.
- POJOs کتابخانه‌های 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 (Legacy)
- Distance Matrix API (Legacy)
- Elevation API
- Geocoding API
- Places API
- Roads API
- Time Zone API