יש להעביר את התגובה של Places API

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

מבוא

הפורמט של התגובה בממשקי ה-API‏ Place Details (New)‏, חיפוש בקרבת מקום (New) ו-חיפוש טקסט (New) השתנה לעומת הפורמט של ממשקי ה-API הקודמים. ההבדל העיקרי הוא בפורמט של אובייקט Place שמוחזר על ידי כל שיטה, כפי שמתואר במאמר שינויים באובייקט המקום בתגובה.

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

שינויים באובייקט המקום של התגובה

בטבלה הזו מוצגים השינויים באובייקט new‏ Place בתגובה לפרטי מקום (חדש), לחיפוש בקרבת מקום (חדש) ולחיפוש טקסטואלי (חדש) בהשוואה לאובייקט legacy‏ Place.

באובייקט התגובה החדש נעשה שימוש ב-camel-casing לשמות השדות, הוא מכיל שדות חדשים וחלק מהשדות הקודמים קיבלו שמות חדשים.

שדה אובייקט Places API (קודם) אובייקט Places API (חדש) הערות
רכיב בכתובת address_components addressComponents
כתובת במיקרופורמט של מקום adr_address adrFormatAddress
הסטטוס של העסק business_status businessStatus
שעות הפתיחה בשבוע הבא current_opening_hours currentOpeningHours
תקציר המערכת editorial_summary editorialSummary
כתובת בפורמט פתוח formatted_address formattedAddress
מספר טלפון לאומי formatted_phone_number nationalPhoneNumber
מיקום geometry.location location
אזור התצוגה geometry.viewport viewport
ייחוס זכויות יוצרים (קרדיט) למקומות html_attributions attributions שדה ברמה העליונה של התגובה בממשקי API מדור קודם
כתובת אתר של סמל icon הנושא הוסר. משתמשים ב-iconMaskBaseUri וב-iconBackgroundColor. מידע נוסף זמין במאמר בנושא סמלי מקומות.
צבע רקע סמל icon_background_color iconBackgroundColor
כתובת ה-URL של מסכת הסמל icon_mask_base_uri iconMaskBaseUri
מספר טלפון בינלאומי international_phone_number internationalPhoneNumber
שם מקום בטקסט name displayName השם של המקום בטקסט זמין עכשיו בתור displayName.text ובתור language בתור displayName.languageCode
שעות פתיחה opening_hours regularOpeningHours
תמונות photos photos הפורמט של photos השתנה באובייקט Place החדש. מידע נוסף זמין במאמר בנושא שינוי להפניות לתמונות.
מזהה מקום place_id id
Plus Code plus_code plusCode
רמת מחירים price_level priceLevel
דירוג rating rating
ביקורות reviews reviews
שעות הפתיחה המשניות לשבוע הבא החל מהיום, עם חריגים וכל שאר הנתונים secondary_opening_hours currentSecondaryOpeningHours
סוגי מקומות types types
כתובת URL במפות Google של המקום url googleMapsUri
מספר דירוגי המשתמשים user_ratings_total userRatingCount
הפרש משעון UTC utc_offset utcOffsetMinutes
כתובת מקוצרת שכוללת את שם הרחוב והעיר vicinity shortFormattedAddress
אתר האינטרנט של המקום website websiteUri
פרטים על נגישות לכיסאות גלגלים wheelchair_accessible_entrance accessibilityOptions ‫wheelchair_accessible_entrance נמצאת עכשיו ב-accessibilityOptions.wheelchairAccessibleEntrance
מאפייני מקומות takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
שם המשאב השדה name בטופס places/PLACE_ID ב-API מדור קודם, השדה name הכיל את שם המקום כמחרוזת טקסט. ב-API החדש, המידע הזה נמצא ב-displayName.
הסוג הראשי של המקום primaryTypeName חדש
הצבת הסוג הראשי כמחרוזת טקסט primaryTypeDisplayName חדש
שעות פתיחה משניות קבועות לשבוע, עם חריגים וכל שאר הנתונים regularSecondaryOpeningHours חדש
אפשרויות התשלום שהמקום מקבל paymentOptions חדש
אפשרויות חניה במקום parkingOptions חדש
רשימה של יעדי משנה שקשורים למקום subDestinations חדש
המידע העדכני ביותר על אפשרויות הדלק בתחנת דלק fuelOptions חדש
מידע על טעינת רכבים חשמליים במקום מסוים evChargeOptions חדש
מאפייני מקומות outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports חדש

שינויים בתשובות של חיפוש טקסט

בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה בחיפוש טקסט (גרסה קודמת) ושל אובייקט התגובה בחיפוש טקסט (גרסה חדשה). ב-API החדש, השדה היחיד ברמה העליונה בתגובה הוא מערך places.

שדה חיפוש טקסט (גרסה קודמת) חיפוש טקסט (חדש) הערות
ייחוס זכויות יוצרים (קרדיט) למקומות html_attributions עבר לאובייקט Place החדש לכל מקום בתור place.attributions
מערך של מקומות מערך results של אובייקטים מהטיפוס Place (קודם) מערך places של אובייקט Place חדש
סטטוס הבקשה status הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)
הודעות שגיאה error_message הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)
הודעות מידע info_messages הוסר
טוקן דף next_page_token הוסר

שינויים בתגובה של חיפוש בקרבת מקום

בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה של חיפוש בקרבת מקום (מהדור הקודם) ושל אובייקט התגובה של חיפוש בקרבת מקום (החדש). ב-API החדש, השדה היחיד ברמה העליונה בתגובה הוא מערך places.

שדה חיפוש בקרבת מקום (גרסה קודמת) חיפוש בקרבת מקום (חדש) הערות
ייחוס זכויות יוצרים (קרדיט) למקומות html_attributions הועבר לאובייקט Place החדש לכל מקום בתור place.attributions
מערך של מקומות מערך results של אובייקטים מהטיפוס Place (קודם) ‫places מערך של אובייקט Place חדש
סטטוס הבקשה status הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)
הודעות שגיאה error_message הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)
הודעות מידע info_messages הוסר
טוקן דף next_page_token הוסר

שינויים בתגובה של Place Details (חדש)

בטבלה הבאה מפורטים השינויים בשדות ברמה העליונה של אובייקט התגובה של Place Details (Legacy) ושל אובייקט התגובה של Place Details (New). ב-API החדש, השדה היחיד ברמה העליונה בתגובה הוא מערך places.

שדה Place Details (Legacy) Place Details (New) הערות
ייחוס זכויות יוצרים (קרדיט) למקומות html_attributions הועבר לאובייקט Place החדש בתור attributions
Place Details (New) ‫result שמכיל את האובייקט Place מדור קודם אובייקט Place חדש
סטטוס הבקשה status הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)
הודעות מידע info_messages הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)