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

פורמט התשובות לממשקי ה-API החדשים של Place Details, Nearby Search ו-Text Search , השתנה מהפורמט של ממשקי ה-API הקיימים. ההבדל העיקרי הוא בפורמט של האובייקט Place שמוחזר בכל שיטה, כפי שמתואר במאמר שינויים באובייקט Placeholder

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

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

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

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

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

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

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

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

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