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

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

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

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

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

בטבלה הזו מוצגים השינויים באובייקט החדש 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
שיוך זכויות יוצרים (Attribution) של מקומות	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	חדש
מידע על תחנות טעינה לרכב חשמלי (EV) במקום מסוים		evChargeOptions	חדש
מאפייני מקומות		outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports	חדש

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

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

שדה	חיפוש טקסט (דור קודם)	חיפוש טקסט (חדש)	הערות
שיוך זכויות יוצרים (Attribution) של מקומות	html_attributions		הועברו לאובייקט Place החדש לכל מקום כ-place.attributions
מערך של מקומות	מערך results של אובייקט Place מדור קודם	מערך places של האובייקט החדש מסוג Place
סטטוס הבקשה	status		הועבר לתגובת ה-HTTP הרגילה (קוד ותשובת HTTP)
הודעות שגיאה	error_message		הועבר לתגובת ה-HTTP הרגילה (קוד ותשובת HTTP)
הודעות מידע	info_messages		הוסר
טוקן דף	next_page_token		הוסר

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

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

שדה	חיפוש בקרבת מקום (דור קודם)	חיפוש בקרבת מקום (חדש)	הערות
שיוך זכויות יוצרים (Attribution) של מקומות	html_attributions		הועברו לאובייקט Place החדש לכל מקום בתור place.attributions
מערך של מקומות	מערך results של אובייקט Place מדור קודם	מערך places של האובייקט החדש Place
סטטוס הבקשה	status		הועבר לתגובת ה-HTTP הרגילה (קוד ותשובת HTTP)
הודעות שגיאה	error_message		הועבר לתגובת ה-HTTP הרגילה (קוד ותשובת HTTP)
הודעות מידע	info_messages		הוסר
טוקן דף	next_page_token		הוסר

שינויים בתשובה 'פרטי המקום (חדש)'

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

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