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

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

מבוא

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

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

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

בטבלה הזו מוצגים השינויים באובייקט Place החדש בתגובה לפרטי מקום (חדש), לחיפוש בקרבת מקום (חדש) ולחיפוש טקסט (חדש), בהשוואה לאובייקט 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 הוסר

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

בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה של Nearby Search (גרסה קודמת) ושל אובייקט התגובה של Nearby Search (גרסה חדשה). ב-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 (חדש) הערות
ייחוס זכויות יוצרים (קרדיט) למקומות html_attributions הועבר לאובייקט Place החדש בתור attributions
Place Details (חדש) ‫result שמכיל את אובייקט Place מדור קודם אובייקט Place חדש
סטטוס הבקשה status הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)
הודעות מידע info_messages הועבר לתגובת HTTP רגילה (קוד תגובת HTTP והודעה)