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

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

מבוא

פורמט התגובה של ממשקי ה-API הבאים השתנה לעומת הפורמט של ממשקי ה-API מדור קודם: ‫Place Details (New), ‫Nearby Search (New), ו-Text Search (New). ההבדל העיקרי הוא בפורמט של אובייקט 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 והודעה)