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

ב-Places SDK ל-Android יש תמיכה ב פרטי המיקום הקיימים. אם אתם מכירים את Places SDK ל-Android, הגרסה החדשה של פרטי המקומות כוללת את השינויים הבאים:

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

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

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

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

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

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

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

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

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

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

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

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

למידע נוסף, קראו את המאמר שיוך.

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

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

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

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

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

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

הגדרת קידומת חיוג אזורית

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

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

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

בקשה לדוגמה

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