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

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

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

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

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

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