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

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

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

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

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

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

שדה אובייקט קיים של מקום אובייקט מקום חדש הערות
רכיב בכתובת 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 חדש
מידע על תחנות טעינה לרכב חשמלי (EV) במקום מסוים evChargeOptions חדש
מאפייני מקומות outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports חדש

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

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

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

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

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