Places SDK ל-Android תומך ב-Place Details (Legacy). אם אתם מכירים את Places SDK ל-Android (גרסה קודמת), Place Details (New) כולל את השינויים הבאים:
משתמש במודל תמחור חדש. מידע על תמחור של כל ממשקי ה-API זמין במאמר Places SDK for Android (חדש).
צריך לאתחל את האפליקציה באמצעות קריאה לשיטה
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 עם קוד שפה, צריך:
כוללים את
Place.Field.DISPLAY_NAMEברשימת השדות של הבקשה. הערך הזה מגדיר את התשובה כך שתכלול גם את שם המקום וגם את קוד השפה באובייקטPlace.מתקשרים אל
PlacesClient.fetchPlace(). PlacesClient.findCurrentPlace()לא תומך בשדה של קוד השפה.משתמשים ב-method
Place.getNameLanguageCode()כדי לגשת לשדה של קוד השפה באובייקטPlace.
הגדרת קוד אזור
ב-Places SDK ל-Android (חדש) נוסף פרמטר הבקשה region_code לפרטי המקום. קוד האזור משמש לעיצוב התשובה, והוא מוגדר כערך של קוד CLDR בן שני תווים. הפרמטר הזה יכול גם להטות את תוצאות החיפוש. אין ערך ברירת מחדל. כדי להגדיר את קוד האזור, צריך להפעיל את ה-SDK החדש.
אם שם המדינה בשדה הכתובת בתגובה תואם לקוד האזור, קוד המדינה מושמט מהכתובת.
רוב הקודים של CLDR זהים לקודי ISO 3166-1, עם כמה יוצאים מן הכלל. לדוגמה, ה-ccTLD של בריטניה הוא uk (.co.uk), אבל קוד ISO 3166-1 שלה הוא gb (טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד'). הפרמטר יכול להשפיע על התוצאות בהתאם לחוק הרלוונטי.
דוגמה לבקשה
דוגמה מלאה זמינה במאמר פרטי מקום (חדש).