מבוא
אחרי שמקבלים מזהה מקום, אפשר לשלוח בקשה מסוג Place Details (New) כדי לקבל פרטים נוספים על עסק או נקודת עניין ספציפיים. בקשה ל-Place Details (New) מחזירה מידע מקיף יותר על המקום שצוין, כמו הכתובת המלאה, מספר הטלפון, דירוג המשתמשים והביקורות.
יש הרבה דרכים לקבל מזהה מקום. אתם יכולים להשתמש:
- חיפוש טקסט (חדש) או חיפוש בסביבה (חדש)
- Geocoding API
- Routes API
- Address Validation API
- השלמה אוטומטית (חדש)
בעזרת APIs Explorer אתם יכולים לשלוח בקשות בזמן אמת כדי להכיר את ה-API ואת האפשרויות שלו:
בקשות ל-Place Details (New)
בקשה לפרטי מקום (חדש) היא בקשת HTTP GET בפורמט הבא:
https://places.googleapis.com/v1/places/PLACE_ID
מעבירים את כל הפרמטרים כפרמטרים של כתובת URL או בכותרות כחלק מבקשת ה-GET. לדוגמה:
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEYאו בפקודת curl:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
תגובות של Place Details (New)
התגובה של Place Details (New) היא אובייקט JSON. בתשובה:
- התגובה מיוצגת על ידי אובייקט
Place. האובייקטPlaceמכיל מידע מפורט על המקום. - השדה FieldMask שמועבר בבקשה מציין את רשימת השדות שמוחזרים באובייקט
Place.
אובייקט ה-JSON המלא הוא בפורמט:
{ "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g", "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g", "displayName": { "text": "Trinidad" } ... }
פרמטרים נדרשים
-
FieldMask
מציינים את רשימת השדות שיוחזרו בתגובה על ידי יצירת מסכת שדה תגובה. מעבירים את מסכת השדות של התגובה ל-method באמצעות הפרמטר של כתובת ה-URL
$fieldsאוfields, או באמצעות כותרת ה-HTTPX-Goog-FieldMask. אין רשימת ברירת מחדל של שדות שמוחזרים בתגובה. אם משמיטים את מסכת השדה, השיטה מחזירה שגיאה.הסתרת שדות היא שיטה מומלצת לעיצוב, שנועדה להבטיח שלא תבקשו נתונים מיותרים, וכך להימנע מזמן עיבוד מיותר ומחיובים מיותרים.
צריך לציין רשימה מופרדת בפסיקים של סוגי נתוני המקומות שרוצים לקבל. לדוגמה, כדי לאחזר את השם המוצג ואת הכתובת של המקום.
X-Goog-FieldMask: displayName,formattedAddress
אפשר להשתמש ב-
*כדי לאחזר את כל השדות.X-Goog-FieldMask: *
מציינים אחד או יותר מהשדות הבאים:
השדות הבאים מפעילים את המק"ט Place Details Essentials IDs Only:
attributions
consumerAlert
id
movedPlace
movedPlaceId
name*
photos
* השדה
nameמכיל את שם המשאב של המקום בפורמט:places/PLACE_ID. כדי לקבל את השם של המקום בטקסט, צריך לבקש את השדהdisplayNameבמק"ט Pro.רשימה מלאה של השדות והמקט"ים שמשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
השדות הבאים מפעילים את Place Details Essentials SKU:
addressComponents
addressDescriptor*
adrFormatAddress
formattedAddress
location
plusCode
postalAddress
shortFormattedAddress
types
viewport
* תיאורי מיקום זמינים לכלל המשתמשים בהודו, ובמקומות אחרים הם בשלב ניסיוני.
רשימה מלאה של השדות והמקט"ים שמשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
השדות הבאים מפעילים את המק"ט Place Details Pro:
accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks
googleMapsTypeLabel
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
openingDate
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
timeZone
utcOffsetMinutes
רשימה מלאה של השדות והמקט"ים שמשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
השדות הבאים מפעילים את Place Details Enterprise SKU:
currentOpeningHours
currentSecondaryOpeningHours
internationalPhoneNumber
nationalPhoneNumber
priceLevel
priceRange
rating
regularOpeningHours
regularSecondaryOpeningHours
transitStation
userRatingCount
websiteUriרשימה מלאה של השדות והמקט"ים שמשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
השדות הבאים מפעילים את המק"ט Place Details Enterprise + Atmosphere:
allowsDogs
curbsidePickup
delivery
dineIn
editorialSummary
evChargeAmenitySummary
evChargeOptions
fuelOptions
generativeSummary
goodForChildren
goodForGroups
goodForWatchingSports
liveMusic
menuForChildren
neighborhoodSummary
parkingOptions
paymentOptions
outdoorSeating
reservable
restroom
reviews
reviewSummary
routingSummaries*
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
* חיפוש טקסט וחיפוש בסביבה בלבדרשימה מלאה של השדות והמקט"ים שמשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
-
placeId
מזהה טקסטואלי שמזהה מקום באופן ייחודי, ומוחזר מחיפוש טקסט (חדש) או מחיפוש בסביבה (חדש). מידע נוסף על מזהי מקומות זמין בסקירה הכללית של מזהי מקומות.
המחרוזת
places/PLACE_IDנקראת גם שם המשאב של המקום. בתגובה לבקשה של פרטי מקום (חדש), חיפוש בסביבה (חדש) וחיפוש טקסט (חדש), המחרוזת הזו כלולה בשדהnameשל התגובה. מזהה המקום העצמאי מופיע בשדהidשל התשובה.
פרמטרים אופציונליים
languageCode
השפה שבה התוצאות יוחזרו.
- כאן אפשר לעיין ברשימת השפות הנתמכות. Google מעדכנת לעיתים קרובות את השפות הנתמכות, לכן יכול להיות שהרשימה הזו לא מלאה.
-
אם לא מציינים את
languageCode, ברירת המחדל של ה-API היאen. אם תציינו קוד שפה לא חוקי, ה-API יחזיר שגיאתINVALID_ARGUMENT. - ה-API מנסה לספק כתובת רחוב שקריאה גם למשתמש וגם למקומיים. כדי להשיג את המטרה הזו, הוא מחזיר כתובות רחוב בשפה המקומית, עם תעתיק לכתב שהמשתמש יכול לקרוא במידת הצורך, תוך התחשבות בשפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרת מהרכיב הראשון.
- אם השם לא זמין בשפה המועדפת, ה-API משתמש בהתאמה הקרובה ביותר.
- השפה המועדפת משפיעה קצת על קבוצת התוצאות שה-API בוחר להחזיר, ועל הסדר שבו הן מוחזרות. הכלי להמרת כתובות לקואורדינטות מפרש קיצורים באופן שונה בהתאם לשפה, כמו קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת.
regionCode
קוד האזור שמשמש לעיצוב התשובה, שמוגדר כערך של קוד CLDR באורך שני תווים. אין ערך ברירת מחדל.
אם שם המדינה בשדה
formattedAddressבתגובה תואם ל-regionCode, קוד המדינה מושמט מ-formattedAddress. לפרמטר הזה אין השפעה עלadrFormatAddress, שתמיד כולל את שם המדינה, או עלshortFormattedAddress, שאף פעם לא כולל אותו.רוב קודי ה-CLDR זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, ה-ccTLD של בריטניה הוא uk (.co.uk), אבל קוד ה-ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד"). הפרמטר יכול להשפיע על התוצאות בהתאם לדין החל.
-
sessionToken
טוקנים לסשנים הם מחרוזות שנוצרות על ידי המשתמשים, שמאפשרות לעקוב אחרי קריאות להשלמה אוטומטית (חדשה) בתור "סשנים". השלמה אוטומטית (חדשה) משתמשת בטוקנים לסשנים כדי לקבץ את שלבי השאילתה ובחירת המקום של חיפוש עם השלמה אוטומטית של משתמש לסשן נפרד לצורכי חיוב. טוקנים לסשנים מועברים לקריאות ל-Place Details (חדש) שמתבצעות אחרי קריאות ל-Autocomplete (חדש). מידע נוסף זמין במאמר טוקנים לסשנים.
דוגמה ל-Place Details (New)
בדוגמה הבאה נשלחת בקשה לקבלת פרטים של מקום לפי placeId:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
שימו לב שהכותרת X-Goog-FieldMask מציינת שהתגובה מכילה את שדות הנתונים הבאים: id,displayName.
התגובה תהיה בפורמט הבא:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" } }
כדי לקבל מידע נוסף, אפשר להוסיף עוד סוגי נתונים למסכת השדות.
לדוגמה, מוסיפים את formattedAddress,plusCode כדי לכלול את הכתובת ואת Plus Code בתשובה:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
התשובה תהיה בפורמט הבא:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "plusCode": { "globalCode": "849VCWC7+RW", "compoundCode": "CWC7+RW Mountain View, CA, USA" }, "displayName": { "text": "Googleplex", "languageCode": "en" } }
קבלת דירוגים, מספר ביקורות וביקורות
כדי לאחזר את דירוג הכוכבים הממוצע של עסק, את מספר הדירוגים הכולל (סה"כ ביקורות) או את הטקסט של ביקורת הלקוח, צריך לכלול את השדות המתאימים בכותרת X-Goog-FieldMask:
ratingו-userRatingCount: החזרת הדירוג הממוצע של המקום (מ-1.0עד5.0) ומספר הביקורות הכולל. בקשה של השדות האלה מפעילה את המק"ט של Place Details Enterprise.reviewsו-reviewSummary: מחזירים עד חמישה אובייקטים שלReviewשנשלחו על ידי משתמשים וסיכום של הביקורות שנוצר על ידי AI. בקשת השדות האלה מפעילה את המק"ט Place Details Enterprise + Atmosphere.
אם האפליקציה צריכה רק את דירוג הכוכבים ואת מספר הביקורות הכולל, צריך לבקש את
rating
ואת
userRatingCount
בלי
reviews
כדי שהבקשה תישאר ברמה
Place Details Enterprise SKU:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
כדי לאחזר גם עד חמישה אובייקטים מסוג Review שנשלחו על ידי משתמשים, מוסיפים את reviews למסכת השדות (החיוב מתבצע ברמת המק"ט Place Details Enterprise + Atmosphere):
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,rating,userRatingCount,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
התשובה כוללת את הדירוג, מספר הדירוגים הכולל והמערך reviews:
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" }, "rating": 4.2, "userRatingCount": 2594, "reviews": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/...", "relativePublishTimeDescription": "a month ago", "rating": 5, "text": { "text": "Iconic tech campus with visitor areas and cafes.", "languageCode": "en" }, "authorAttribution": { "displayName": "Alex Rivera" } } ] }
קבלת תיאורי כתובות
תיאורי כתובות מספקים מידע יחסי על המיקום של מקום, כולל ציוני דרך בקרבת מקום ואזורים שמכילים את המקום.
הדוגמה הבאה מציגה בקשה ל-Place Details (חדש) של חנות כלבו בקניון בסן חוזה. בדוגמה הזו, אתם כוללים את addressDescriptors במסכת השדה:
curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \ -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: name,displayName,addressDescriptor"
התשובה כוללת את המקום שצוין בבקשה, רשימה של ציוני דרך קרובים והמרחק שלהם מהמקום, ורשימה של אזורים והקשר שלהם למקום:
{ "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4", "displayName": { "text": "Macy's", "languageCode": "en" }, "addressDescriptor": { "landmarks": [ { "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "food", "movie_theater", "point_of_interest", "restaurant", "shoe_store", "shopping_mall", "store" ], "spatialRelationship": "WITHIN", "straightLineDistanceMeters": 220.29175 }, { "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4", "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4", "displayName": { "text": "Nordstrom", "languageCode": "en" }, "types": [ "clothing_store", "department_store", "establishment", "point_of_interest", "shoe_store", "store" ], "straightLineDistanceMeters": 329.45178 }, { "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE", "displayName": { "text": "Monroe Parking Garage", "languageCode": "en" }, "types": [ "establishment", "parking", "point_of_interest" ], "straightLineDistanceMeters": 227.05153 }, { "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM", "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM", "displayName": { "text": "Studios Inn by Daiwa Living California Inc.", "languageCode": "en" }, "types": [ "establishment", "lodging", "point_of_interest", "real_estate_agency" ], "straightLineDistanceMeters": 299.9955 }, { "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI", "displayName": { "text": "Din Tai Fung", "languageCode": "en" }, "types": [ "establishment", "food", "point_of_interest", "restaurant" ], "straightLineDistanceMeters": 157.70943 } ], "areas": [ { "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI", "displayName": { "text": "Westfield Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q", "displayName": { "text": "Valley Fair", "languageCode": "en" }, "containment": "WITHIN" }, { "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM", "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM", "displayName": { "text": "Central San Jose", "languageCode": "en" }, "containment": "WITHIN" } ] } }
איך מקבלים פרטים על מקום שעבר לכתובת אחרת
אם מקום שמופיע באפליקציה שלכם עבר למיקום אחר, אתם יכולים להשתמש בשדות movedPlace ו-movedPlaceId כדי לקבל את הפרטים של המקום החדש.
במקומות שנסגרו לתמיד, הפונקציה Place Details (New) מחזירה את הערך CLOSED_PERMANENTLY בשדה businessStatus ומשמיטה את השדות movedPlace ו-movedPlaceId מגוף התגובה.
במקומות שעברו למיקום חדש, השירות "Place Details (New)" מחזיר את הערך CLOSED_PERMANENTLY בשדה businessStatus, ואת המיקום החדש בשדות movedPlace ו-movedPlaceId של גוף התגובה.
במקומות שלא הועברו, Place Details (חדש) לא מחזיר את movedPlace או את movedPlaceId בגוף התגובה.
הדוגמה הבאה מבקשת מידע על המקום Marche IGA St-Canut בקוויבק, קנדה:
curl -X GET -H 'Content-Type: application/json' \ -H 'x-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \ https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ
הבקשה מחזירה את התגובה הבאה:
{ "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ", "businessStatus": "CLOSED_PERMANENTLY", "displayName": { "text": "Marche IGA St-Canut", "languageCode": "en" }, "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ", "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ" }
כדי לבקש פרטים על המקום החדש, משתמשים בשם המשאב של המקום בשדה movedPlace בבקשה חדשה של Place Details (חדש).
במקומות שעברו כמה פעמים, יכול להיות שתצטרכו לשלוח כמה בקשות משורשרות של Place Details (חדש) כדי לקבל פרטים על המיקום הנוכחי. השדות movedPlace ו-movedPlaceId של תוצאת המקום מצביעים רק על המיקום הבא, ולא על המיקום האחרון הידוע. מקום נמצא במיקום הנוכחי שלו אם בגוף התשובה לבקשה של Place Details (חדש) לא מופיעים השדות movedPlace ו-movedPlaceId.
איך למצוא עסקים שייפתחו בעתיד
אתם יכולים לבקש פרטים על עסקים שצפויים להיפתח בעתיד.
השדה openingDate יאוכלס בחיפוש בסביבה (חדש) אם תאריך הפתיחה הצפוי כולל לפחות את החודש וחל בעוד פחות מ-90 יום.
בדוגמה הבאה מוצגת בקשה לחיפוש בסביבה (חדש) של עסק שנפתח בעתיד בניו מדוז, איידהו:
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,businessStatus,openingDate" \ "https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"
התגובה כוללת את סטטוס העסק של המקום ואת תאריך הפתיחה הצפוי:
{ "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do", "businessStatus": "FUTURE_OPENING", "openingDate": { "year": 2026, "month": 4, "day": 15 } }
קבלת מידע על תחנות של תחבורה ציבורית
אתם יכולים להשתמש ב-Place Details (New) כדי לקבל מידע על תחנות של תחבורה ציבורית. גוף התגובה כולל מידע על התחנה, כולל שם התחנה, חברות התחבורה הציבורית שמשויכות אליה וקווי התחבורה הציבורית שעוברים בה. בנוסף, התשובה כוללת סמל של כלי רכב וצבעים שאפשר להשתמש בהם כדי להציג את המידע על התחנה של התחבורה הציבורית.
בדוגמה הבאה מוצגת בקשה לקבלת מידע על תחנה של תחבורה ציבורית Grand Central Station:
curl -X GET \ -H "Content-Type: application/json" \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,transitStation" \ "https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"
גוף התגובה כולל מידע על כל תחנה ברדיוס, הקווים שעוברים בתחנה, התראות שפורסמו על ידי חברות התחבורה הציבורית בתחנה הזו ומידע על יציאות:
{ "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg", "displayName": { "text": "Grand Central", "languageCode": "en" }, "transitStation": { "displayName": { "text": "Grand Central", "languageCode": "en" }, "agencies": [ { "displayName": { "text": "MTA New York City Transit", "languageCode": "en" }, "url": "http://www.mta.info/", "lines": [ { "id": "ChIJ420yFwBZwokR903kVZLSsFc", "vehicleType": "SUBWAY", "displayName": { "text": "42 St Shuttle", "languageCode": "en" }, "shortDisplayName": { "text": "S", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#808183", "url": "https://www.mta.info/schedules/subway/42-st-shuttle", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } }, { "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM", "vehicleType": "SUBWAY", "displayName": { "text": "5 Train (Lexington Av Express)", "languageCode": "en" }, "shortDisplayName": { "text": "5 Line", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#00933C", "url": "https://www.mta.info/schedules/subway/5-train", "icon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg", "nameIncluded": true }, "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg" } } ... ] }, { "displayName": { "text": "MTA", "languageCode": "en" }, "url": "https://new.mta.info/", "lines": [ { "id": "ChIJcwVpzKpZwokR24EBeh8arww", "vehicleType": "BUS", "displayName": { "text": "United Nations - W 42 St Pier", "languageCode": "en" }, "shortDisplayName": { "text": "M42", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#1D59B3", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg" } } ] }, { "displayName": { "text": "Long Island Rail Road", "languageCode": "en" }, "url": "http://www.mta.info/lirr", "lines": [ { "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0", "vehicleType": "HEAVY_RAIL", "displayName": { "text": "Ronkonkoma Branch", "languageCode": "en" }, "shortDisplayName": { "text": "LIRR", "languageCode": "en" }, "textColor": "#FFFFFF", "backgroundColor": "#A626AA", "vehicleIcon": { "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg" } } ... ] } ], "stops": [ { "id": "ChIJRcemlf1YwokRhFqqw5jKBFM", "stopCode": { "text": "GCT" }, "location": { "latitude": 40.755161, "longitude": -73.975456 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJ57l2zANZwokRD1pyhuwpfKY", "signageText": { "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7", "languageCode": "en" }, "location": { "latitude": 40.750983, "longitude": -73.9750686 }, "wheelchairAccessibleEntrance": true }, { "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc", "displayName": { "text": "E 42 St/Park Av", "languageCode": "en" }, "location": { "latitude": 40.7518199, "longitude": -73.9771918 }, "wheelchairAccessibleEntrance": true } ... ] } }
קבלת כניסות ונקודות ניווט
אתם יכולים לבקש להוסיף כניסות ונקודות ניווט ליעד. כניסות מגדירות את נקודות הכניסה והיציאה של מקום (לדוגמה, שערים שונים בשדה תעופה או בקניון). נקודות ניווט מגדירות מיקומים בצד הדרך שבהם הניווט אמור להסתיים. זה שימושי כדי להפנות משתמשים לצד הנכון של הכביש או לנקודת איסוף או הורדה ספציפית.
נקודות הניווט מחזירות navigationPointToken. אתם יכולים להעביר את הטוקן הזה ל-Navigation SDK (זמין ל-Android או ל-iOS) או ל-Routes API כדי להנחות את הנהגים למיקום הספציפי הזה. מידע נוסף זמין בקטע Navigation point tokens (אסימונים של נקודות ניווט) באתר למפתחים.
בדוגמה הבאה נשלחת בקשה לקבלת פרטים על נמל התעופה הבינלאומי של סן פרנסיסקו (מזהה המקום ChIJVVVVVYx3j4ARP-3NGldc8qQ), כולל entrances ו-navigationPoints במסכת השדות:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \ https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ
התשובה כוללת את הכניסות ונקודות הניווט של המקום:
{ "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ", "displayName": { "text": "San Francisco International Airport", "languageCode": "en" }, "entrances": [ { "location": { "latitude": 37.6172154, "longitude": -122.3839724 } }, { "location": { "latitude": 37.6174073, "longitude": -122.384196 } }, ... ], "navigationPoints": [ { "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...", "displayName": { "text": "International Terminal Departures Level", "languageCode": "en" }, "location": { "latitude": 37.6153121, "longitude": -122.3900833 }, "travelModes": ["WALK"] }, { "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...", "displayName": { "text": "Domestic Garage - SFO Short Term Parking", "languageCode": "en" }, "location": { "latitude": 37.6157153, "longitude": -122.3885012 }, "travelModes": ["DRIVE", "WALK"], "usages": ["PARKING"] }, ... ] }
רוצה לנסות?
ב-APIs Explorer אתם יכולים לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שהוא מציע.
לוחצים על סמל ה-API api בצד שמאל של הדף.
אפשר לערוך את הפרמטרים של הבקשה.
לוחצים על הכפתור Execute. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.
בחלונית APIs Explorer, לוחצים על סמל המסך המלא fullscreen כדי להרחיב את החלון של APIs Explorer.