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

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

מבוא

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

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

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

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

בטבלה הזו מוצגים השינויים באובייקט new Place בתגובה ל-Place Details (חדש), לחיפוש בקרבת מקום (חדש) ולחיפוש טקסט (חדש) בהשוואה לאובייקט legacy 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`		הוסר

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

בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה של חיפוש בקרבת מקום (גרסה קודמת) ושל אובייקט התגובה של חיפוש בקרבת מקום (גרסה חדשה). ב-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 (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 והודעה)