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