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