Google در مارس ۲۰۲۵ Places API قدیمی را منجمد کرد. هنوز کار میکند، اما ویژگیهای جدید دریافت نخواهد کرد، و منسوخسازی در راه است. برای توسعهدهندگان اتحادیه اروپا، تصمیم مهاجرت پیچیدهتر از آن چیزی است که مستندات Google پیشنهاد میدهد.
در مارس ۲۰۲۵، Google بیسروصدا پلتفرم نقشهسازی خود را به روشهایی بازساخت کرد که حتی اگر پیامرسانی ملایم بود، فوریت واقعی برای توسعهدهندگان ایجاد کرد. Places API قدیمی، Directions API و Distance Matrix API همگی به عنوان "سرویسهای قدیمی" طبقهبندی مجدد شدند. هنوز کار میکنند. تا زمانی که Google تاریخ منسوخسازی را اعلام کند به کار خواهند کرد. اما منجمد شدهاند.
بدون ویژگیهای جدید. بدون بهبودهای معماری. تخفیفهای حجمی محدود در سطح ۱۰۰,۰۰۰+ که کمتر از نیاز برنامههای کاربردی بزرگتر است. و در نقطهای در آینده، یک اعلام منسوخسازی با ۱۲ ماه اطلاع همراه.
برای بیشتر توسعهدهندگان، سؤال این نیست که آیا مهاجرت کنند یا نه. سؤال این است که چه زمانی و به کجا.
برای توسعهدهندگان اتحادیه اروپا به طور خاص، محاسبات متفاوت است. تصمیم مهاجرت نه فقط شامل سازگاری API و قیمتگذاری، بلکه شامل انطباق GDPR، اقامت داده و خطر قانونی زیرساخت آمریکایی نیز میشود که مستندات Google به آنها به طور کامل نمیپردازد.
این راهنما آنچه تغییر کرده، آنچه مهاجرت شامل میشود و سؤالاتی که تیمهای اتحادیه اروپا باید قبل از تعهد به یک مسیر بپرسند را پوشش میدهد.
Google در مارس ۲۰۲۵ چه تغییراتی ایجاد کرد
بازساخت مارس ۲۰۲۵ دو جزء متمایز داشت که بسیاری از توسعهدهندگان آنها را با هم اشتباه گرفتند.
بازساخت قیمتگذاری: Google اعتبار ماهانه ثابت ۲۰۰ دلاری را با سطوح رایگان بهازای هر SKU جایگزین کرد. به جای یک اعتبار واحد که میتوانست برای هر ترکیبی از API اعمال شود، اکنون هر نوع API سطح رایگان خود را دارد:
- Geocoding API: ۱۰,۰۰۰ رویداد رایگان در ماه، سپس ۲ تا ۷ دلار برای هر ۱,۰۰۰ رویداد
- Maps JavaScript API: ۱۰,۰۰۰ رویداد رایگان در ماه
- Places API (جدید): سطح رایگان بهازای هر نوع درخواست
- Routes API: سطح رایگان بهازای هر نوع مسیر
برای توسعهدهندگانی که یک API را به شدت زیر اعتبار قدیمی ۲۰۰ دلاری استفاده میکردند، مدل جدید میتواند به معنای پرداخت بیشتر باشد. برای توسعهدهندگانی که در انواع مختلف API توزیع شدهاند، سطوح رایگان بهازای هر SKU ممکن است هزینهها را کاهش دهد. تنها راه دانستن این است که استفاده فعلی خود را در برابر ساختار SKU جدید بررسی کنید.
در کنار تغییر قیمتگذاری، Google طرحهای اشتراک راهاندازی کرد: Starter با ۱۰۰ دلار در ماه (۵۰,۰۰۰ تماس ترکیبی)، Essentials با ۲۷۵ دلار در ماه (۱۰۰,۰۰۰ تماس ترکیبی) و Pro با ۱,۲۰۰ دلار در ماه (۲۵۰,۰۰۰ تماس ترکیبی). این طرحها قرار است در مقیاس پیشبینیپذیری بدهند، اما لایه دیگری از پیچیدگی به پیشبینی هزینه اضافه میکنند.
تعیینهای منسوخسازی API: جداگانه، Google سه API را به عنوان سرویسهای قدیمی تعیین کرد:
- Places API (قدیمی): با Places API (جدید) جایگزین شده
- Directions API: با Routes API جایگزین شده
- Distance Matrix API: با Routes API با computeRouteMatrix جایگزین شده
تعیین "قدیمی" به این معناست که این APIها ویژگیهای جدید دریافت نمیکنند و واجد شرایط سطوح تخفیف حجمی گسترشیافته جدید نیستند. آنها در حالت نگهداری هستند.
Places API (جدید) واقعاً چه چیزی را تغییر میدهد
Places API جدید یک جایگزین مستقیم نیست. فرمت درخواست متفاوت، ساختار پاسخ متفاوت و مدل انتخاب فیلد متفاوت دارد.
مهمترین تغییر پوششگذاری فیلد است. API قدیمی یک ساختار پاسخ ثابت برمیگرداند. API جدید از شما میخواهد که از طریق یک هدر field mask مشخص کنید به کدام فیلدها نیاز دارید. این انتقال دادههای غیرضروری را کاهش میدهد و به این معناست که فقط برای فیلدهایی که درخواست میکنید پرداخت میکنید، اما همچنین به این معناست که هر تماس API در کد شما باید با پوششهای فیلد صریح بهروز شود.
تفاوتهای کلیدی که توسعهدهندگان در طول مهاجرت با آنها روبرو میشوند:
فرمت درخواست: API جدید از درخواستهای POST با بدنه JSON به جای درخواستهای GET با پارامترهای query استفاده میکند. اگر یکپارچهسازی شما تماسهای مبتنی بر URL میسازد، هر تماس باید بازساخت شود.
ساختار پاسخ: نام فیلدها تغییر کرده است. formatted_address به formattedAddress (camelCase) تبدیل میشود. place_id به id تبدیل میشود. شیء geometry بازساخت شده است. کد تجزیه پاسخ باید در سراسر بررسی شود.
ویژگیهای جدید فقط در Places API (جدید): خلاصههای AI مولد، فیلدهای داده جدید برای ایستگاههای شارژ EV، قیمتهای سوخت، جزئیات دسترسی و پیشنهادهای تکمیل خودکار بهبودیافته. اگر به هر یک از اینها نیاز دارید، باید مهاجرت کنید.
مدیریت عکس: فرمت مرجع عکس تغییر کرده است. URLهای عکس تولیدشده توسط API قدیمی در نهایت کار نخواهند کرد، بنابراین هر مرجع عکس کششده باید بازتولید شود.
Google راهنماهای مهاجرت ارائه میدهد، اما تجربه عملی نشان میدهد که مهاجرت یک کار مهندسی معنادار است، نه یک تغییر پیکربندی. تیمها معمولاً یک تا چهار هفته بسته به پیچیدگی یکپارچهسازی بودجه میگذارند.
مهاجرت Routes API (جداگانه اما مرتبط)
Directions API و Distance Matrix API از الگوی مشابهی پیروی میکنند. جایگزین Routes API است که از فرمت درخواست/پاسخ متفاوتی استفاده میکند و ویژگیهایی ارائه میدهد که APIهای قدیمی ندارند: مسیریابی آگاه از ترافیک، اصلاحکنندههای مسیر، پشتیبانی از دوچرخههای موتوری و بهینهسازی بازده سوخت.
Routes API همچنین متفاوت قیمتگذاری میشود. Directions API قدیمی بهازای عنصر (جفت مبدأ-مقصد) قیمتگذاری میکرد. Routes API بهازای درخواست مسیر و بهازای عنصر در درخواستهای ماتریسی قیمتگذاری میکند. برای برنامههایی که حجم بالایی از درخواستهای ماتریسی دارند، هزینهها ممکن است به طور قابل توجهی تغییر کنند.
اگر در حال مهاجرت Places API هستید، برنامهریزی مهاجرت Routes API در همان زمان ارزش دارد نه دو مهاجرت جداگانه. تلاش موازی کارآمدتر از مهاجرتهای متوالی است که هر کدام به چرخههای آزمایش و استقرار مستقل نیاز دارند.
ملاحظات خاص اتحادیه اروپا
اینجاست که تصمیم مهاجرت برای توسعهدهندگان اروپایی پیچیدهتر از آن چیزی میشود که مستندات Google نشان میدهد.
GDPR و انتقال دادههای برونمرزی
Google Maps Platform زیرساخت آمریکایی است. وقتی مرورگر کاربر درخواستی به Places API ارسال میکند یا نقشه بارگذاری میکند، آن درخواست از طریق سرورهای مستقر در آمریکای Google عبور میکند. تحت GDPR، این یک انتقال داده برونمرزی است.
مبنای قانونی فعلی برای این انتقالها چارچوب حریم خصوصی داده EU-US است که جایگزین توافقنامه Privacy Shield منسوخشده توسط حکم Schrems II در سال ۲۰۲۰ شد. DPF از نظر قانونی به چالش کشیده شده و ثبات بلندمدت آن تضمین نشده است. برای شرکتها در صنایع تنظیمشده (بهداشت، فینتک، خدمات حقوقی، برنامههای مرتبط با دولت)، اتکای مستمر به زیرساخت آمریکایی یک مکالمه انطباق مداوم است که نیاز به نظارت دارد.
استفاده از Google Maps API همچنین در برخی پیادهسازیها به رضایت cookie برای JavaScript API نیاز دارد، زیرا آدرسهای IP کاربر و شناسههای دستگاه به Google ارسال میشود. برای برنامههایی که میخواهند نقشهها را بدون فعال کردن نوار رضایت بارگذاری کنند، زیرساخت میزبانیشده در آمریکا یک مشکل ساختاری ایجاد میکند.
Google در سال ۲۰۲۵ شرایط خدمات Maps Platform EEA را بهروز کرد تا به طور خاص برای آدرسهای صورتحساب اتحادیه اروپا اعمال شود. توسعهدهندگان باید شرایط بهروزشده را در برابر الزامات DPA خود بررسی کنند.
سادهسازی انطباق به عنوان محرک مهاجرت
برای بسیاری از تیمهای اتحادیه اروپا، تغییرات مارس ۲۰۲۵ یک محرک عملی برای ارزیابی مجدد ماندن در اکوسیستم Google یا انتقال به یک جایگزین میزبانیشده در اتحادیه اروپا فراهم کرد.
استدلال تجاری برای ارزیابی مجدد ساده است: اگر قرار است در هر صورت زمان مهندسی را در مهاجرت سرمایهگذاری کنید (Places API قدیمی به Places API جدید)، تلاش اضافی نهایی برای مهاجرت به یک ارائهدهنده متفاوت اغلب کمتر از آن چیزی است که به نظر میرسد. تغییرات endpoint API، کار نگاشت فیلد و چرخههای آزمایش تقریباً یکسان است چه به API جدید Google مهاجرت کنید چه به یک جایگزین شخص ثالث. تفاوت در آن چیزی است که وقتی تمام میکنید به دست میآورید.
یک API نقشه میزبانیشده در اتحادیه اروپا نگرانی انتقال داده برونمرزی GDPR را کاملاً حذف میکند. تمام درخواستها در اتحادیه اروپا باقی میمانند. بدون SCC برای مذاکره، بدون اتکا به DPF، بدون نیاز به رضایت cookie برای بارگذاری نقشه. برای شرکتهایی که اخیراً ممیزیهای GDPR را تکمیل کردهاند یا منتظر انجام آن هستند، این سادهسازی ارزش سازمانی واقعی دارد.
ارزیابی مهاجرت در Google یا تغییر ارائهدهنده
چارچوب صادقانه برای این تصمیم چهار بخش دارد.
۱. استفاده فعلی API خود را بررسی کنید
قبل از تصمیمگیری، هر تماس Places API، Directions API و Distance Matrix API در کد خود را نقشهبرداری کنید. حجم را بهازای هر نوع endpoint بشمارید. آن را در برابر هر دو مدل قیمتگذاری Places API (جدید) و endpointهای معادل در ارائهدهندگان جایگزین نامزد قرار دهید.
مقایسه هزینه فقط با دادههای استفاده واقعی منطقی است. تخمینهای تقریبی بر اساس حجم کل درخواست کافی نیست زیرا APIهای مختلف در یک ارائهدهنده متفاوت قیمتگذاری میشوند.
۲. مواجهه GDPR را ارزیابی کنید
از تیم حقوقی یا انطباق خود بپرسید که وابستگی به زیرساخت آمریکایی چه میزان خطر مداوم برای زمینه خاص شما نشان میدهد. برای یک محصول SaaS با مشتریان سازمانی اتحادیه اروپا که DPA دارند، سطح خطر با یک برنامه مصرفکننده که دادههای شخصی حساس پردازش میکند متفاوت است.
اگر سادهسازی انطباق ارزشمند است، هزینهای به آن اختصاص دهید. سربار حقوقی داخلی نگهداری SCC، نظارت بر ثبات DPF و رسیدگی به پرسشنامههای انطباق مشتریان کار واقعی با هزینه واقعی است.
۳. تلاش مهاجرت را برای هر مسیر ارزیابی کنید
مهاجرت به Places API (جدید) در Google: بر اساس پیچیدگی یکپارچهسازی خود تخمین بزنید. تغییرات پوششگذاری فیلد، بازساخت درخواست، بهروزرسانی تجزیه پاسخ. معمولاً یک تا چهار هفته تلاش مهندسی.
مهاجرت به یک جایگزین شخص ثالث: محدوده مهندسی مشابه. تغییرات URL endpoint، تفاوتهای پارامتر، تفاوتهای فرمت پاسخ. برای تیمهایی که از MapLibre GL JS به عنوان لایه رندرینگ استفاده میکنند (fork منبع باز Mapbox GL JS)، لایه رندرینگ یکسان باقی میماند. فقط تماسهای geocoding، جستجو و مسیریابی تغییر میکنند.
۴. در نظر بگیرید در طرف دیگر چه به دست میآورید
Places API (جدید) به شما دسترسی به آخرین ویژگیهای Google را میدهد: تکمیل خودکار بهتر، خلاصههای AI مولد، دادههای مکان گسترشیافته. پوشش داده Google در سطح جهانی بینظیر است.
جایگزینهای میزبانیشده در اتحادیه اروپا مانند MapAtlas انطباق GDPR را به عنوان طراحی، اقامت داده در اتحادیه اروپا و در برخی موارد ابزار دیده شدن در جستجوی AI که APIهای Google ارائه نمیدهند فراهم میکنند. برای برنامههایی در حوزههای املاک، مهماننوازی یا لجستیک که قابلیت کشف AI صفحات مکانی اهمیت دارد، لایه دیده شدن AI یک تمایز معنادار است.
هیچ مسیری به طور جهانی درست نیست. پاسخ درست به الزامات انطباق، حساسیت قیمتگذاری و اینکه کدام ویژگیها برای برنامه شما بیشتر اهمیت دارند بستگی دارد.
همین الان چه کاری انجام دهید
صرفنظر از اینکه کدام مسیر مهاجرت را انتخاب میکنید، چند اقدام فوری منطقی است:
سطح API فعلی خود را بررسی و مستند کنید: دقیقاً بدانید از کدام endpointهای قدیمی استفاده میکنید، چه مقدار و به کدام فیلدهای داده وابستهاید. این اطلاعات برای هر تصمیم مهاجرتی لازم است.
مقایسه قیمت را با اعداد واقعی انجام دهید: از دادههای استفاده واقعی خود برای مقایسه قیمتگذاری قدیمی، قیمتگذاری Places API (جدید) و ارائهدهندگان جایگزین استفاده کنید. این کار را در حجم فعلی و دو برابر حجم فعلی انجام دهید.
مستندات GDPR خود را بررسی کنید: DPA فعلی با Google، SCC یا اتکای DPF و پیادهسازی رضایت cookie را مرور کنید. موقعیت قانونی فعلی خود را قبل از تغییر آن درک کنید.
تحت فشار زمانی مهاجرت نکنید: API قدیمی هنوز کار میکند. منجمد است، نه شکسته. تصمیم مهاجرت را با دادههای روشن و زمان مهندسی کافی بگیرید نه به خاطر عجلهای که از اضطراب درکشده ناشی میشود. اعلام منسوخسازی ۱۲ ماه اطلاع به شما میدهد.
ضربالاجل تصمیم تعیین کنید: "وقتی Google منسوخسازی را اعلام کند" یک برنامه نیست. یک نقطه تصمیم داخلی برای اینکه کدام مسیر مهاجرت را انتخاب میکنید تعیین کنید، ترجیحاً در سه ماه آینده.
اگر میخواهید مقایسه کنید که APIهای نقشه میزبانیشده در اتحادیه اروپا از نظر سطح API، قیمتگذاری و تلاش مهاجرت چه شکلی هستند، MapAtlas geocoding، تکمیل خودکار آدرس، مسیریابی و کاشیهای نقشه را تحت یک مدل قیمتگذاری با اقامت داده در اتحادیه اروپا پوشش میدهد. صفحه قیمتگذاری ساختار سطح فعلی را نشان میدهد، و سطح رایگان (۱۰,۰۰۰ درخواست در ماه برای بیشتر APIها، ۲۵,۰۰۰ برای geocoding) به شما اجازه میدهد یکپارچهسازی را قبل از تعهد آزمایش کنید.
سوالات متداول
Google چه زمانی Places API قدیمی را منسوخ میکند؟
Google تا اوایل ۲۰۲۶ تاریخ منسوخسازی نهایی تعیین نکرده است. API قدیمی در مارس ۲۰۲۵ منجمد شد و دیگر ویژگیهای جدید دریافت نمیکند. سیاست Google ارائه حداقل ۱۲ ماه اطلاع قبل از منسوخسازی است. مهاجرت را فوری اما نه اورژانسی بدانید.
آیا Places API (جدید) گرانتر از Places API قدیمی است؟
بستگی به الگوی استفاده شما دارد. سطوح رایگان جدید بهازای هر SKU برخی الگوهای استفاده را سود میرسانند و برخی دیگر را آسیب میزنند. تماسهای API فعلی خود را با ساختار SKU جدید با دادههای استفاده واقعی قبل از نتیجهگیری بررسی کنید.
آیا باید از Directions API هم مهاجرت کنم؟
بله، اگر ویژگیهای جدید و تخفیفهای حجمی بهتر میخواهید. Directions API و Distance Matrix API هر دو در مارس ۲۰۲۵ به عنوان سرویسهای قدیمی تعیین شدند. جایگزین Routes API است که به ارزیابی مهاجرت جداگانه خود نیاز دارد.
خطر GDPR ادامه استفاده از Google Maps API به عنوان توسعهدهنده اتحادیه اروپا چیست؟
Google Maps Platform از زیرساخت آمریکایی استفاده میکند که تحت GDPR به مکانیزمهای انتقال داده برونمرزی نیاز دارد. مبنای فعلی چارچوب حریم خصوصی داده EU-US است که از نظر قانونی به چالش کشیده شده است. برای صنایع تنظیمشده، این یک خطر انطباق مداوم است که نیاز به نظارت دارد.
مهاجرت به یک ارائهدهنده جایگزین چقدر طول میکشد؟
تلاش مهندسی مشابه مهاجرت در Google است: یک تا چهار هفته بسته به پیچیدگی یکپارچهسازی، بیشتر صرف بهروزرسانی endpoint، تفاوتهای پارامتر و آزمایش فرمت پاسخ میشود. تیمهایی که از MapLibre GL JS برای رندرینگ استفاده میکنند سبکترین مسیر مهاجرت را دارند زیرا لایه رندرینگ یکسان باقی میماند.
نتیجهگیری
تغییرات مارس ۲۰۲۵ ساعتی روی استفاده از Places API قدیمی قرار داد بدون اینکه رسماً شمارش معکوس را شروع کند. API هنوز کار میکند. تاریخ منسوخسازی اعلام نشده است. اما جهت مشخص است، و مهاجرت با برنامهریزی کافی کمتر دردناک خواهد بود تا با اضطراب.
برای توسعهدهندگان اتحادیه اروپا، لحظه مهاجرت همچنین یک لحظه ارزیابی است. تلاش مهندسی برای تغییر endpointهای API تقریباً یکسان است چه در Google بمانید چه به یک جایگزین میزبانیشده در اتحادیه اروپا منتقل شوید. تفاوت معنادار در چیزی است که با خود حمل میکنید: مجموعه داده جهانی جامع Google و آخرین ویژگیها، یا انطباق GDPR به عنوان طراحی، قیمتگذاری سادهتر و اقامت داده در اتحادیه اروپا.
این تصمیمی است که ارزش تصمیمگیری عمدی، با دادههای استفاده واقعی و دید روشن از الزامات انطباق، را دارد، به جای پیشفرض گرفتن مسیر کمترین مقاومت فوری.
مطالعه بیشتر:
- جایگزینهای Google Maps API برای توسعهدهندگان اتحادیه اروپا
- راهنمای توسعهدهنده اتحادیه اروپا برای APIهای نقشه سازگار با GDPR
- قیمتگذاری Google Maps API 2026: واقعاً چقدر میپردازید
- تغییر از Google Maps API: توسعهدهندگان اتحادیه اروپا چه انتخاب میکنند
- API تکمیل خودکار آدرس: چگونه نرخ تبدیل صفحه پرداخت را بهبود میبخشد
سوالات متداول
Google چه زمانی Places API قدیمی را منسوخ میکند؟
Google تا اوایل ۲۰۲۶ تاریخ منسوخسازی نهایی برای Places API قدیمی تعیین نکرده است. با این حال، سیاست رسمی Google ارائه حداقل ۱۲ ماه اطلاع قبل از منسوخسازی است. API قدیمی در مارس ۲۰۲۵ به عنوان 'سرویس قدیمی' تعیین شد، به این معنا که دیگر ویژگیهای جدید دریافت نمیکند و تخفیفهای حجمی در سطح ۱۰۰,۰۰۰+ محدود شده است. توسعهدهندگان باید مهاجرت را حتی بدون ضربالاجل سختی فوری بدانند.
آیا Places API (جدید) گرانتر از Places API قدیمی است؟
بستگی به الگوی استفاده شما دارد. Places API جدید از مدل قیمتگذاری متفاوتی با سطوح رایگان بهازای هر SKU به جای اعتبار ماهانه ۲۰۰ دلاری قدیمی استفاده میکند. برای برخی الگوهای استفاده، هزینهها مشابه یا کمتر است. برای برخی دیگر، بهویژه توسعهدهندگانی که به اعتبار ثابت برای پوشش انواع مختلف API متکی بودند، مدل جدید میتواند گرانتر باشد. تنها راه مطمئن برای دانستن این است که تماسهای API فعلی خود را با ساختار SKU جدید مقایسه کنید و قبل از مهاجرت اعداد را بررسی کنید.
آیا باید از Directions API هم مهاجرت کنم؟
بله، اگر میخواهید به ویژگیهای جدید و تخفیفهای حجمی بهتر دسترسی داشته باشید. Google Directions API و Distance Matrix API را در همان زمان Places API، در مارس ۲۰۲۵، به عنوان سرویسهای قدیمی تعیین کرد. جایگزینها Routes API (برای مسیریابی) و Routes API با computeRouteMatrix (برای ماتریس مسافت) هستند. مهاجرت از Places API جداست و ارزیابی مستقل خود را میطلبد.
خطر GDPR ادامه استفاده از Google Maps API به عنوان توسعهدهنده اتحادیه اروپا چیست؟
Google Maps Platform دادهها را در زیرساخت آمریکا پردازش میکند، به این معنا که استفاده از آن شامل انتقال دادههای برونمرزی تحت GDPR میشود. این نیازمند یا بندهای قراردادی استاندارد یا اتکا به چارچوب حریم خصوصی داده EU-US است. DPF قبلاً از نظر قانونی به چالش کشیده شده و ثبات بلندمدت آن تضمین نشده است. برای شرکتها در صنایع تنظیمشده (بهداشت، فینتک، دولت)، این در معرض قرار گرفتن قانونی یک نگرانی مستمر جدی است.
مهاجرت از Google Places API به یک جایگزین چقدر طول میکشد؟
مهاجرت به Places API (جدید) در اکوسیستم Google معمولاً یک تا چهار هفته طول میکشد بسته به پیچیدگی یکپارچهسازی. مهاجرت به یک جایگزین شخص ثالث مدت مشابهی طول میکشد: بیشتر صرف بهروزرسانی URLهای endpoint، بررسی تفاوتهای پارامتر و آزمایش فرمتهای پاسخ geocoding و جستجو میشود. برای تیمهایی که از MapLibre GL JS به عنوان لایه رندرینگ استفاده میکنند، مهاجرت رندرینگ اغلب سریعترین بخش است. آزمایش geocoding و API جستجو جایی است که بیشترین تلاش صرف میشود.
