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

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

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

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

הטבלה הבאה מציגה את השינויים בשדות ברמה העליונה של אובייקט של תגובה ב-Text Search אובייקט של תשובה לחיפוש טקסט (חדש). כשמדובר ב-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
מגוון מקומות	מערך results של האובייקט הקיים Place	מערך places של הערך החדש אובייקט Place
סטטוס הבקשה	status		הועברה לתגובת ה-HTTP הרגילה (קוד תגובת HTTP והודעה)
הודעות שגיאה כלשהן	error_message		הועברה לתגובת ה-HTTP הרגילה (קוד תגובת HTTP והודעה)
הודעות מידע	info_messages		הוסר
אסימון דף	next_page_token		הוסר

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

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

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