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

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

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

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

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

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

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

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

השיטה 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. משתמשים בשיטה Place.getNameLanguageCode() כדי לגשת לשדה של קוד השפה באובייקט Place.

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

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

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

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

בקשה לדוגמה

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