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

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

מבוא

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

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

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

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

באובייקט התגובה החדש, השמות של השדות כתובים בפורמט CamelCase, יש בו שדות חדשים וחלק מהשדות הקודמים קיבלו שמות חדשים.

שדה אובייקט 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 (גרסה קודמת) ושל אובייקט התגובה של Place Details (גרסה חדשה). ב-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)