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