החל מאוקטובר 2026, לא ניתן יותר להפעיל את 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 (דור קודם): מתי כדאי להשתמש בו
מתי כדאי להשתמש ב-Places API (דור קודם):
- יש לכם פרויקט קיים שבו כבר מופעל Places API (דור קודם) והוא שולח קריאות לנקודות קצה (endpoints) של
maps.googleapis.com/maps/api/place. - כדי שהקריאות הקיימות ל-Find Place, לחיפוש בסביבה, לחיפוש טקסט, לפרטים, לתמונות או להשלמה אוטומטית (דור קודם) ימשיכו לפעול במהלך ההעברה, צריך:
מתי לא כדאי להשתמש ב-Places API (דור קודם):
- אתם מתחילים פרויקט חדש ב-Google Cloud. החל מאוקטובר 2026, לא תהיה אפשרות להפעיל את Places API (מדור קודם) בפרויקטים חדשים. במקום זאת, צריך להשתמש ב-Places API (חדש).
- אתם צריכים תכונות חדשות, אימות OAuth או מסכות שדות בחיפוש בסביבה ובחיפוש טקסט, כדי לשלם רק על השדות שאתם מבקשים. במקום זאת, צריך להשתמש ב-Places API (חדש).
- אתם צריכים את Find Place (מדור קודם) או את Query Autocomplete (מדור קודם) בקוד חדש. הם הוחלפו בחיפוש טקסט (חדש) ובהשלמה אוטומטית (חדש). במקום זאת, צריך להשתמש ב-Places API (חדש).
Places API (דור קודם): הגדרה
- השירות שצריך להפעיל:
places-backend.googleapis.com - אימות: מפתח API
- תמחור: שימוש וחיוב ב-Places API (דור קודם)
- כללי מדיניות: כללי המדיניות של Places API (הדור הקודם)
Places API (דור קודם): טעויות נפוצות
- בעיה: אם בבקשה ל-Place Details (ממשק קודם) לא מציינים את הפרמטר
fieldsאו לא מציינים שדות, ה-API מחזיר את כל השדות ומחייב אתכם על כולם. הפתרון: תמיד צריך להגדיר את הפרמטרfields, או לעבור ל-Place Details (חדש) עם מסכת שדות. מידע נוסף זמין בכתובת /maps/documentation/places/web-service/legacy/details. - הבעיה: בגרסאות הקודמות של "חיפוש בסביבה" ו"חיפוש טקסט" אי אפשר לציין אילו שדות יוחזרו. הן תמיד מחזירות קבוצה קבועה של שדות (קבוצת משנה של שדות Place Details) ומפעילות את המק"טים Basic Data, Contact Data ו-Atmosphere Data. התיקון: עוברים ל-חיפוש בסביבה (New) או ל-חיפוש טקסט (New) עם מסכת שדות, או משתמשים ב-חיפוש מקום (Legacy) עם הפרמטר
fieldsכדי לבקש ולשלם רק על השדות שצריך. מידע נוסף זמין בכתובת /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - הבעיה: אי אפשר לשמור
photo_referenceבמטמון והוא יכול לפוג, כך שהפניות שמורות מפסיקות לפעול. הפתרון: לפני ששולחים בקשה לתמונה, צריך לקבלphoto_referenceחדש מתגובה של Place Details, Find Place, חיפוש בסביבה או חיפוש טקסט. מידע נוסף זמין בכתובת /maps/documentation/places/web-service/legacy/photos. - הבעיה: קריאות ל-Places API (דור קודם) מפרויקט שלא מופעל בו ה-API הזה מחזירות את השגיאה
REQUEST_DENIEDעם הודעת השגיאה "You're calling a legacy API, which is not enabled for your project..." (אתם שולחים קריאה ל-API מדור קודם שלא מופעל בפרויקט שלכם...) (LegacyApiNotActivatedMapError). החל מאוקטובר 2026, לא תהיה אפשרות להפעיל את Places API (דור קודם) בפרויקטים חדשים. הפתרון: משתמשים ב-Places API (החדש) בפרויקטים חדשים ומעבירים אליו אפליקציות קיימות. בזמן המעבר, אתם יכולים לבקש הפעלה לטווח קצר של ה-API הקודם באמצעות טופס המשוב בדף הקודם. מידע נוסף זמין בכתובת /maps/legacy#LegacyApiNotActivatedMapError.
Places API (דור קודם): תכונות מהדור הקודם שהוצאו משימוש
- שדה התגובה
permanently_closed: הוצא משימוש ב-26 במאי 2020. החלפה: השדהbusiness_status. למדריך להעברת נתונים (מיגרציה) - שדה התגובה
reference: הוצא משימוש ב-3 בספטמבר 2019. החלפה: השדהplace_id. למדריך להעברת נתונים (מיגרציה) - פרמטר הבקשה
nameשל "חיפוש בסביבה (הגרסה הקודמת)": הוצא משימוש. החלפה: הפרמטרkeyword. למדריך להעברת נתונים (מיגרציה)