מבוא
פורמט התגובה של ממשקי ה-API פרטי מקום (חדש), חיפוש בסביבה (חדש) וחיפוש טקסט (חדש) השתנה בהשוואה לפורמט של ממשקי ה-API הקודמים. ההבדל העיקרי הוא בפורמט של האובייקט Place שמוחזר על ידי כל שיטה, כפי שמתואר בקטע שינויים באובייקט Place בתגובה.
בנוסף, השדות ברמה העליונה של אובייקט התגובה השתנו גם הם בכל API. אפשר לעיין במאמרים הבאים:
שינויים באובייקט Place בתגובה
בטבלה הזו מוצגים השינויים באובייקט החדש Place בתגובה ל-Place Details (חדש), לחיפוש בסביבה (חדש) ולחיפוש טקסט (חדש) בהשוואה לאובייקט הקודם Place.
אובייקט התגובה החדש משתמש בקאמל קייס לשמות השדות, מכיל שדות חדשים ומשנה את השמות של חלק מהשדות הקודמים.
| שדה | אובייקט 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 |
הוסר |
שינויים בתגובה של "חיפוש בסביבה"
בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה בגרסת הקודמת של "חיפוש בסביבה" ושל אובייקט התגובה בגרסה החדשה של "חיפוש בסביבה". ב-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 (New)
בטבלה הבאה מוצגים השינויים בשדות ברמה העליונה של אובייקט התגובה ב-Place Details (דור קודם) ושל אובייקט התגובה ב-Place Details (חדש). ב-API החדש, השדה היחיד ברמה העליונה בתגובה הוא המערך places.
| שדה | Place Details (גרסה קודמת) | Place Details (New) | הערות |
|---|---|---|---|
| ייחוס זכויות יוצרים (קרדיט) למקומות | html_attributions |
הועבר לאובייקט Place החדש בתור attributions |
|
| Place Details (New) | result שמכיל את האובייקט Place הקודם |
אובייקט Place החדש | |
| סטטוס הבקשה | status |
עברנו לתגובת HTTP רגילה (קוד תגובה והודעה של HTTP) | |
| הודעות מידע כלשהן | info_messages |
עברנו לתגובת HTTP רגילה (קוד תגובה והודעה של HTTP) |