מעבר מ'פרטי מקום' (גרסה קודמת) ל'פרטי מקום' (חדש)

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

‫Places SDK ל-Android (מדור קודם) תומך ב-Place Details (מדור קודם). אם אתם מכירים את Place Details (Legacy), כדאי לדעת שב-Place Details (New) בוצעו השינויים הבאים:

  • משתמש במודל תמחור חדש. למידע על התמחור של כל ממשקי ה-API, אפשר לעיין במאמר שימוש וחיוב.

  • צריך לאתחל את האפליקציה באמצעות הקריאה לשיטה Places.initializeWithNewPlacesApiEnabled(). מידע נוסף על בחירת שירות Places API זמין במאמר בנושא הגדרת פרויקט Google Cloud.

  • חובה לבצע אנונימיזציה של השדה. צריך לציין אילו שדות רוצים להחזיר בתגובה. אין רשימת ברירת מחדל של שדות שמוחזרים. אם לא מציינים את הרשימה הזו, השיטות מחזירות שגיאה.

בקטעים הבאים מתוארים שינויים נוספים.

גישה לסוגים חדשים של מקומות

לכל מקום יכול להיות ערך type אחד או יותר שמשויך אליו. בגרסה 3.3.0 ואילך של Places SDK for Android נוספו הרבה ערכי סוג חדשים. הרשימה המלאה מופיעה במאמר בנושא סוגי מקומות מורחבים.

ה-method‏ Place.getPlaceTypes() מחזיר את ערכי הסוג כרשימה של ערכי מחרוזת. הערכים שמוחזרים תלויים בגרסה של Places SDK ל-Android:

  • ‫Places SDK ל-Android (חדש): מחזיר את המחרוזות שמוגדרות בטבלה א' ובטבלה ב' שמוצגות בסוגי מקומות (חדש), כולל כל סוגי המקומות שנוספו בגרסה 3.3.0.

  • ‫Places SDK ל-Android (מדור קודם): מחזיר את סוגי ה-enum שמוגדרים על ידי Place.Types, שלא כולל את הסוגים החדשים שנוספו בגרסה 3.3.0 ואילך.

גישה לביקורות על מקומות

‫Places SDK ל-Android (חדש) מוסיף את המחלקה Review, שמכילה ביקורת על מקום. אובייקט Place יכול להכיל עד חמש ביקורות.

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

מידע נוסף מופיע במאמר בנושא שיוכים.

קוד השפה של שם המקום

ב-Places SDK ל-Android (מדור קודם), השיטה Place.getName() מחזירה מחרוזת טקסט שמכילה את שם המקום. כדי לאכלס את האובייקט Place בשם המקום, צריך לכלול את Place.Field.DISPLAY_NAME ברשימת השדות של בקשת פרטי המקום.

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

  1. כוללים את Place.Field.DISPLAY_NAME ברשימת השדות של הבקשה. הערך הזה מגדיר את התשובה כך שתכלול גם את שם המקום וגם את קוד השפה באובייקט Place.

  2. מתקשרים אל PlacesClient.fetchPlace(). ‫PlacesClient.findCurrentPlace() לא תומך בשדה של קוד השפה.

  3. משתמשים ב-Place.getNameLanguageCode() method כדי לגשת לשדה של קוד השפה באובייקט Place.

הגדרת קוד אזור

ב-Places SDK ל-Android (חדש) נוסף פרמטר הבקשה region_code לפרטי המקום. קוד האזור משמש לעיצוב התשובה, והוא מוגדר כערך בן שני תווים של קוד CLDR. הפרמטר הזה יכול גם להטות את תוצאות החיפוש. אין ערך ברירת מחדל. כדי להגדיר את קוד האזור, צריך להפעיל את ה-SDK החדש.

אם שם המדינה בשדה הכתובת בתגובה תואם לקוד האזור, קוד המדינה מושמט מהכתובת.

רוב הקודים של CLDR זהים לקודים של ISO 3166-1, עם כמה יוצאים מן הכלל. לדוגמה, ה-ccTLD של בריטניה הוא uk (‎.co.uk), אבל קוד ISO 3166-1 שלה הוא gb (טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד'). הפרמטר יכול להשפיע על התוצאות בהתאם לדין החל.

דוגמה לבקשה

דוגמה מלאה זמינה במאמר פרטי מקום (גרסה קודמת).