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