סקירה כללית על מיגרציה

מפתחים באזור הכלכלי האירופי (EEA)

במדריך הזה מודגשים ההבדלים העיקריים בין שירות Places הקודם לבין המחלקה החדשה Place. לשדרוג למחלקה Place יש יתרונות משמעותיים, כולל ביצועים משופרים ומודל תמחור חדש. כדי להפיק את המקסימום מ-Places ולוודא שהאפליקציות שלכם מעודכנות, כדאי להכיר את השינויים שמפורטים במדריך הזה.

שיטות מומלצות לחיוב בהעברה

ההנחיות האלה רלוונטיות אם השימוש שלכם ב-API גבוה מספיק כדי לעבור לתמחור ברמה השנייה. כשעוברים לגרסה חדשה יותר של API, מחויבים גם על מק"ט אחר. כדי להימנע מעלויות גבוהות יותר בחודש המעבר, מומלץ לעבור לממשקי ה-API החדשים בסביבת הייצור קרוב ככל האפשר לתחילת החודש. כך תוכלו להגיע לרמות התמחור החודשיות המשתלמות ביותר במהלך חודש ההעברה. למידע על רמות התמחור, קראו את דף התמחור ואת השאלות הנפוצות בנושא תמחור.

הפעלת Places API

הכיתה Place מסתמכת על השירות של Places API. כדי להשתמש בתכונות של המחלקה החדשה Place, צריך קודם להפעיל את Places API (החדש) בפרויקט ב-Google Cloud. איך מתחילים?

שינויים כלליים

בטבלה הבאה מפורטים כמה מההבדלים העיקריים בין PlacesService לבין Place:

‫PlacesService (השיטה הקודמת) Place (חדש)
השיטות דורשות שימוש בקריאה חוזרת (callback) כדי לטפל באובייקט התוצאות ובתגובה של google.maps.places.PlacesServiceStatus. משתמש ב-Promises ופועל באופן אסינכרוני.
השיטות דורשות בדיקת PlacesServiceStatus. אין בדיקת סטטוס נדרשת, אפשר להשתמש בטיפול בשגיאות רגילות.
שדות הנתונים של המקומות מעוצבים עם קו תחתון בין המילים. שדות הנתונים של המקום מעוצבים בפורמט קאמל קייס.
מוגבל לקבוצה קבועה של סוגי מקומות ושדות נתונים של מקומות. מציע מבחר מורחב של סוגי מקומות ושדות נתונים של מקומות שמתעדכנים באופן קבוע.

שינויים ספציפיים ל-API

הכיתה Place מספקת API לשימוש בספריית המקומות, ותומכת בדפוסי שימוש מודרניים כמו Promises. המחלקה Place חושפת את אותם שדות נתונים וסוגי מקומות כמו Places Service הקודם, וכוללת ערכים חדשים רבים לשדות נתונים ולסוגי מקומות.

בטבלה הזו מוצג המיפוי של התכונות של Places Service לאלה של המחלקה Place:

שירות Places (דור קודם) סיווג המקום (חדש)
שדות של נתוני מקומות שדות נתונים של סיווג מקומות
סוגי מקומות סוגי מקומות
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
כיתה Autocomplete כיתה PlaceAutocompleteElement
כיתה SearchBox ---

טעינה של ספריית המקומות

האופן שבו האפליקציה טוענת את ספריית המקומות תלוי ברכיב הטעינה להפעלת ה-API שבו משתמשים. אם האפליקציה משתמשת בייבוא דינמי של ספריות, אפשר לטעון את הספריות הנדרשות בזמן הריצה באמצעות האופרטור await כדי להפעיל את importLibrary(), כמו שמוצג כאן:

const { Place } = await google.maps.importLibrary("places");

אם האפליקציה משתמשת בתג לטעינה ישירה של סקריפט, צריך לבקש את הספרייה places בסקריפט הטעינה:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>

מידע נוסף על טעינת Maps JavaScript API

בקטע הזה מופיעים המדריכים הבאים שיעזרו לכם להעביר את האפליקציות שלכם לגרסה החדשה של Places API: