פרטי מקום (חדש)

בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט

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

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

• חיפוש טקסט (חדש)
• חיפוש בקרבת מקום (חדש)
• השלמה אוטומטית (חדש)

הערה: התכונה 'פרטי מקום (חדש)' זמינה ב-Place SDK ל-Android בגרסה 3.3.0 ואילך. מידע נוסף זמין במאמר בחירת ה-SDK שלך של הגרסה.

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

אפשר לבקש פרטי מקום בטלפון PlacesClient.fetchPlace() ולהעביר FetchPlaceRequest שמכיל מזהה מקום ורשימת שדות, וגם כמו פרמטרים אופציונליים:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

הערה: מידע נוסף על אתחול PlacesClient זמין כאן אתחול לקוח ה-Places API.

אפשר להשתמש בCancellationToken לנסות לבטל בקשה לאחד מסיווגי הבקשות (לדוגמה, FetchPlaceRequest). הביטול נעשה על בסיס התוצאה הטובה ביותר. אחרי ששולחים בקשת ביטול, לא מוחזרת תשובה. הנפקת אסימון ביטול אינה מבטיחה שבקשה מסוימת תבוטל, וייתכן שעדיין תחויבו עבור הבקשה, גם אם לא מוחזרת תשובה.

תשובות בנושא פרטי מקום (חדש)

השדה 'פרטי מקום (חדש)' מחזיר נתונים בצורת Place אובייקט, שכולל רק את השדות שביקשת באמצעות השדה list. התוצאות של נתוני המקום לא יכולות להיות ריקות, לכן צריך רק תוצאות של מקומות עם נתונים מוחזרים (לדוגמה, אם למקום מבוקש אין תמונות, השדה 'תמונות' לא יופיע בתוצאה).

כדי לגשת לשדות הנתונים, מפעילים method. לדוגמה, כדי לגשת לשם של המקום, צריך להתקשר למספר getName().

פרמטרים נדרשים

הפרמטרים הנדרשים עבור FetchPlaceRequest הן:

• מזהה מקום

  מזהה טקסטואלי שמזהה באופן ייחודי מקום, שהוחזר Text Search (New) (חיפוש טקסט (חדש)), חיפוש בקרבת מקום (חדש), או השלמה אוטומטית (חדש). מידע נוסף על מזהי מקומות זמין סקירה כללית על מזהה המקום.

• רשימת שדות

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

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

  צריך לציין אחד או יותר מהשדות הבאים:

  • השדות הבאים מפעילים את המק"ט של פרטי המקום (מזהים בלבד):

    Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

  • השדות הבאים מפעילים את המק"ט של פרטי המקום (מיקום בלבד):

    Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

  • השדות הבאים מפעילים את המק"ט של פרטי המקום (בסיסי):

    Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

  • השדות הבאים מפעילים את המק"ט של פרטי המקום (מתקדם):

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

  • השדות הבאים מפעילים את המק"ט של פרטי המקום (מועדף):

    Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

פרמטרים אופציונליים

הפרמטרים האופציונליים עבור FetchPlaceRequest הן:

• קוד אזור

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

  אם שם המדינה בשדה Place.Field.ADDRESS בתשובה זהה לשם של המדינה regionCode, קוד המדינה לא צוין ב-Place.Field.ADDRESS.

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

  כדי להגדיר את הפרמטר של קוד האזור, צריך להפעיל את השיטה setRegionCode() כשמפתחים את האובייקט FetchPlaceRequest.

• אסימון הסשן

  אסימוני סשן הם מחרוזות שנוצרות על ידי משתמשים ועוקבות אחרי השלמה אוטומטית של שיחות כ'סשנים'. השלמה אוטומטית (חדש) משתמשת באסימוני הפעלה כדי לקבץ את שלבי השאילתה ובחירת המקום של חיפוש ההשלמה האוטומטית של המשתמש לסשן נפרד למטרות חיוב. אסימוני הסשן מועברים לפרטי המקום (חדש) קריאות שמגיעות לאחר הפעלות של השלמה אוטומטית (חדש). מידע נוסף זמין במאמר הבא: אסימונים של סשן.

  כדי להגדיר את הפרמטר של אסימון הסשן, צריך להפעיל את ה-method setSessionToken() כשיוצרים את האובייקט FetchPlaceRequest.

דוגמה לפרטי מקום

בדוגמה הבאה נשלחת בקשה לשדות ID, NAME ו-ADDRESS עבור בניין האמפייר סטייט בניו יורק.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);