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

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

‫Places SDK ל-Android תומך ב-Place Details (מדור קודם). אם אתם מכירים את הכלי 'פרטי מקום' (גרסה קודמת), הכלי 'פרטי מקום' (גרסה חדשה) כולל את השינויים הבאים:

  • משתמש במודל תמחור חדש. מידע על תמחור של כל ממשקי ה-API זמין במאמר Places SDK for Android (חדש).

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

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

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

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

לכל מקום יכול להיות ערך 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 (חדש) מוסיף את פרמטר הבקשה של קוד האזור ל-Place Details. קוד האזור משמש לעיצוב התשובה, והוא מוגדר כערך בן שני תווים של קוד CLDR. הפרמטר הזה יכול גם להטות את תוצאות החיפוש. אין ערך ברירת מחדל. כדי להגדיר את קוד האזור, צריך להפעיל את ה-SDK החדש.

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

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

דוגמה לבקשה

דוגמה מלאה מופיעה במאמר בנושא פרטי מקום (חדש).