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

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

מבוא

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

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

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

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

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

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

בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה של 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 (Legacy) ושל אובייקט התגובה של Place Details (New). ב-API החדש, השדה היחיד ברמה העליונה בתגובה הוא המערך places.

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