העברת התגובה של Places API (מדור קודם)

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

מבוא

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

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

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

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