مرجع سریع Places API (قدیمی)

از اکتبر ۲۰۲۶، Places API (قدیمی) دیگر نمی‌تواند برای پروژه‌های جدید Google Cloud فعال شود. پروژه‌های موجود همچنان به‌طور کامل پشتیبانی می‌شوند. برای ویژگی‌های جدید و عملکرد بهبودیافته، به Places API (جدید) منتقل شوید.

Places API (قدیمی): حقایق کلیدی

  • محصول: Places API (قدیمی)
  • با این نام‌ها نیز شناخته می‌شود: Places API (سرویس وب قدیمی)، سرویس وب Places API‏ (maps/api/place)
  • دسته: مکان‌ها
  • پلاتفرم: سرویس وب (REST)
  • اجرا در: سرور (کد پسین)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: قدیمی
  • جایگزین‌شده با: Places API (جدید)
  • نمای کلی: نمای کلی Places API (قدیمی)

Places API (Legacy): زمان استفاده از آن

در موارد زیر از Places API (قدیمی) استفاده کنید:

  • پروژه موجودی را نگهداری می‌کنید که ازقبل Places API (قدیمی) در آن فعال است و نقاط پایانی maps.googleapis.com/maps/api/place را فراخوانی می‌کند.
  • برای اینکه تماس‌های موجود «یافتن مکان»، «جستجوی اطراف»، «جستجوی نوشتار»، «جزئیات»، Photos، یا «تکمیل خودکار» (قدیمی) درطول انتقال همچنان کار کنند، به آن‌ها نیاز دارید.

در موارد زیر از Places API (قدیمی) استفاده نکنید:

  • درحال شروع پروژه Google Cloud جدیدی هستید. از اکتبر ۲۰۲۶، Places API (قدیمی) را نمی‌توان برای پروژه‌های جدید فعال کرد. درعوض از Places API (New) استفاده کنید.
  • به ویژگی‌های جدید، اصالت‌سنجی OAuth، یا ماسک‌های فیلد در «جستجوی اطراف» و «جستجوی نوشتار» نیاز دارید تا فقط برای فیلدهایی که درخواست می‌کنید هزینه پرداخت کنید. درعوض از Places API (New) استفاده کنید.
  • در کد جدید به Find Place (Legacy) یا Query Autocomplete (Legacy) نیاز دارید. «جستجوی نوشتار (جدید)» و «تکمیل خودکار (جدید)» جایگزین آن‌ها می‌شوند. درعوض از Places API (New) استفاده کنید.

Places API (Legacy): setup

Places API (Legacy): common mistakes

  • مشکل: اگر درخواست «جزئیات جا (قدیمی)» پارامتر fields را حذف کند یا هیچ فیلدی را مشخص نکند، API همه فیلدها را برمی‌گرداند و برای همه آن‌ها صورت‌حساب صادر می‌کند. راه‌حل: همیشه پارامتر fields را تنظیم کنید یا با ماسک فیلد به «جزئیات مکان (جدید)» منتقل شوید. /maps/documentation/places/web-service/legacy/details را ببینید.
  • مشکل: «جستجوی اطراف» (قدیمی) و «جستجوی نوشتار» (قدیمی) از مشخص کردن فیلدهای برگشتی پشتیبانی نمی‌کنند. این روش‌ها همیشه مجموعه ثابتی از فیلدها (زیرمجموعه‌ای از فیلدهای «جزئیات جا») را برمی‌گردانند و واحدهای نگهداری موجودی «داده‌های پایه»، «داده‌های تماس»، و «داده‌های جو» را راه‌اندازی می‌کنند. اصلاح: با ماسک فیلد به «جستجوی اطراف» (جدید) یا «جستجوی نوشتار» (جدید) منتقل شوید، یا از «پیدا کردن مکان» (قدیمی) با پارامتر fields استفاده کنید تا فقط فیلدهای موردنیازتان را درخواست کنید و هزینه آن‌ها را بپردازید. /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku را ببینید.
  • مشکل: photo_reference نمی‌تواند در حافظه نهان ذخیره شود و ممکن است منقضی شود، بنابراین ارجاع‌های ذخیره‌شده دیگر کار نمی‌کنند. اصلاح: قبل‌از درخواست عکس، photo_reference جدیدی از پاسخ «جزئیات جا»، «یافتن جا»، «جستجوی اطراف»، یا «جستجوی نوشتار» دریافت کنید. /maps/documentation/places/web-service/legacy/photos را ببینید.
  • مشکل: تماس با Places API (قدیمی) از پروژه‌ای که آن را فعال نکرده است، REQUEST_DENIED را با پیام خطای «شما درحال تماس با یک API قدیمی هستید که برای پروژه شما فعال نیست...» برمی‌گرداند. (LegacyApiNotActivatedMapError). از اکتبر ۲۰۲۶، Places API (قدیمی) را نمی‌توان برای پروژه‌های جدید فعال کرد. راه‌حل: برای پروژه‌های جدید از Places API (جدید) استفاده کنید و برنامه‌های موجود را انتقال دهید. درطول انتقال، می‌توانید ازطریق فرم بازخورد در صفحه قدیمی، فعال‌سازی کوتاه‌مدت میانای برنامه‌سازی کاربردی قدیمی را درخواست کنید. /maps/legacy#LegacyApiNotActivatedMapError را ببینید.

Places API (Legacy): legacy and deprecated features

  • فیلد پاسخ permanently_closed: منسوخ‌شده از ۲۰۲۰-۰۵-۲۶. جایگزینی: فیلد business_status. راهنمای انتقال را ببینید.
  • فیلد پاسخ reference: منسوخ‌شده از ۲۰۱۹/۰۹/۰۳. جایگزینی: فیلد place_id. راهنمای انتقال را ببینید.
  • پارامتر درخواست «جستجوی اطراف» (قدیمی) name: منسوخ‌شده. جایگزین: پارامتر keyword. راهنمای انتقال را ببینید.