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

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

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

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

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

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

הטבלה הבאה מציגה את השינויים בשדות ברמה העליונה של אובייקט של תגובה בחיפוש טקסט קיים אובייקט של תשובה לחיפוש טקסט (חדש). כשמדובר ב-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
מערך של מקומות מערך results של האובייקט הקיים Place מערך places של האובייקט החדש Place
סטטוס הבקשה status הועבר לתגובת ה-HTTP הרגילה (קוד ותגובה של HTTP)
הודעות שגיאה error_message הועבר לתגובת ה-HTTP הרגילה (קוד תגובת ה-HTTP והודעה)
כל הודעות המידע info_messages הוסרה
טוקן דף next_page_token הוסרה

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

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

שדה פרטי המקום (קיים) פרטי המקום (חדש) הערות
שיוך זכויות יוצרים (Attribution) למקומות html_attributions עוברים למקום החדש אובייקט בתור attributions
פרטי המקום result שמכיל את האובייקט הקיים Place האובייקט Place החדש
סטטוס הבקשה status הועבר לתגובת ה-HTTP הרגילה (קוד ותשובת HTTP)
הודעות מידע info_messages הועברה לתגובת ה-HTTP הרגילה (קוד תגובת HTTP והודעה)