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