חיפוש טקסט (חדש) מחזיר מידע על קבוצת מקומות לפי מחרוזת. לדוגמה: "פיצה בתל אביב", "חנויות נעליים ליד רוטשילד" או "הרצל 12". השירות משיב עם רשימה של מקומות שתואמים למחרוזת הטקסט וכל הטיית מיקום שהוגדרה.
השירות הזה שימושי במיוחד ליצירת שאילתות עם כתובות שונות במערכת אוטומטית, ורכיבים שאינם כתובות במחרוזת עשויים להתאים גם לעסקים וגם לכתובות. דוגמאות לשאילתות לא חד-משמעיות של כתובת הן כתובות בפורמט שגוי או בקשות שכוללות רכיבים שאינם כתובות, כמו שמות עסקים. בקשות כמו שתי הדוגמאות הראשונות בטבלה הבאה עשויות להחזיר אפס תוצאות, אלא אם מוגדר מיקום – כמו אזור, הגבלת מיקום או הטיית מיקום.
"הרצל 10, בריטניה" או "הרצל 12, ישראל" | מספר "רחובות ראשיים" בבריטניה, מספר "רחובות ראשיים" בארה"ב. השאילתה לא מחזירה תוצאות רצויות, אלא אם הוגדרה הגבלת מיקום. |
"ChainRestaurant ניו יורק" | מספר סניפים של "ChainRestaurant" בניו יורק; אין שם רחוב או אפילו שם רחוב. |
'הרצל 10, ישראל' או 'הרצל 111, ישראל" | רק "סטריט אחד" אחד בעיר אשר בבריטניה; רק "רחוב ראשי" אחד בעיר פלסנטון, קליפורניה. |
"UniqueRestaurantName ניו יורק" | מוסד אחד בלבד עם השם הזה בניו יורק. אין צורך בכתובת פיזית כדי להבדיל בין השירותים. |
"פיצה מסעדות בתל אביב" | השאילתה הזו מכילה את הגבלת המיקום שלה ו "פיצריות" הן סוג מוגדר היטב של מקום. התוצאה מחזירה מספר תוצאות. |
"+1 514-670-8700" | השאילתה הזו מכילה מספר טלפון. היא מחזירה כמה תוצאות של מקומות שמשויכים למספר הטלפון הזה. |
באמצעות API Explorer תוכלו ליצור בקשות בזמן אמת כדי להכיר את ה-API ואת אפשרויות ה-API:
בקשות של חיפוש טקסט
בקשת חיפוש טקסט היא בקשת HTTP POST בפורמט הבא:
https://places.googleapis.com/v1/places:searchText
העברה של כל הפרמטרים בגוף הבקשה של JSON או בכותרות כחלק מבקשת ה-POST. למשל:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
תשובות מחיפוש טקסט (חדש)
Text Search (New) מחזיר אובייקט JSON כתגובה. בתשובה:
- המערך
places
מכיל את כל המקומות התואמים. - כל מקום במערך מיוצג על ידי אובייקט
Place
. האובייקטPlace
מכיל מידע מפורט על מקום יחיד. - השדה FieldMask שמועבר בבקשה מציין את רשימת השדות שמוחזרים באובייקט
Place
.
אובייקט ה-JSON המלא מופיע בתבנית:
{ "places": [ { object (Place) } ] }
פרמטרים נדרשים
-
FieldMask
מציינים את רשימת השדות שיוחזרו בתשובה על ידי יצירת אנונימיזציה של שדות בתשובה. מעבירים את המסכה של שדות התשובה ל-method באמצעות הפרמטר
$fields
אוfields
של כתובת ה-URL, או באמצעות כותרת ה-HTTPX-Goog-FieldMask
. אין רשימת ברירת מחדל של השדות שהוחזרו בתשובה. אם משמיטים את מסיכת השדות, השיטה מחזירה שגיאה.כדאי לבצע אנונימיזציה של שדות כדי לוודא שלא מבקשים נתונים מיותרים, וכך חוסכים זמן עיבוד וחיובים מיותרים.
מציינים רשימה מופרדת בפסיקים של סוגי נתוני המקומות שרוצים להחזיר. לדוגמה, כדי לאחזר את השם המוצג ואת הכתובת של המקום.
X-Goog-FieldMask: places.displayName,places.formattedAddress
אפשר להשתמש ב-
*
כדי לאחזר את כל השדות.X-Goog-FieldMask: *
צריך לציין אחד או יותר מהשדות הבאים:
השדות הבאים מפעילים את המק"ט של חיפוש טקסט (מזהה בלבד):
places.attributions
,places.id
,places.name
*,nextPageToken
* השדהplaces.name
מכיל את שם המשאב בפורמט הבא:places/PLACE_ID
. משתמשים ב-places.displayName
כדי לגשת לשם הטקסט של המקום.השדות הבאים מפעילים את Text Search (Basic) SKU:
places.accessibilityOptions
,places.addressComponents
,places.adrFormatAddress
,places.businessStatus
,places.displayName
,places.formattedAddress
,places.googleMapsUri
,places.iconBackgroundColor
,places.iconMaskBaseUri
,places.location
,places.photos
,places.plusCode
,places.primaryType
,places.primaryTypeDisplayName
,places.shortFormattedAddress
,places.subDestinations
,places.types
,places.utcOffsetMinutes
,places.utcOffsetMinutes
,places.utcOffsetMinutes
places.viewport
השדות הבאים מפעילים את מק"ט של חיפוש טקסט (מתקדם):
places.currentOpeningHours
,places.currentSecondaryOpeningHours
,places.internationalPhoneNumber
,places.nationalPhoneNumber
,places.priceLevel
,places.rating
,places.regularOpeningHours
,places.regularSecondaryOpeningHours
,places.userRatingCount
,places.websiteUri
השדות הבאים מפעילים את מק"ט של חיפוש טקסט (מועדף):
places.allowsDogs
,places.curbsidePickup
,places.delivery
,places.dineIn
,places.editorialSummary
,places.evChargeOptions
,places.fuelOptions
,places.goodForChildren
,places.goodForGroups
,places.goodForWatchingSports
,places.liveMusic
,places.menuForChildren
,places.parkingOptions
,places.paymentOptions
,places.outdoorSeating
,places.reservable
,places.restroom
,places.reviews
,places.reviews
,places.reviews
,places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDessert
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
-
textQuery
מחרוזת הטקסט שצריך לחפש בה, לדוגמה: "מסעדה", "הרצל 123" או "המקום הטוב ביותר לביקור בתל אביב". ה-API מחזיר התאמות אפשריות על סמך המחרוזת הזו, ומסדר את התוצאות לפי הרלוונטיות לכאורה שלהן.
פרמטרים אופציונליים
includedType
מגבילה את התוצאות למקומות שתואמים לסוג שצוין כפי שהוגדר על ידי טבלה א'. אפשר לציין סוג אחד בלבד. למשל:
"includedType":"bar"
"includedType":"pharmacy"
languageCode
השפה שבה יוחזרו תוצאות.
- לרשימת השפות הנתמכות Google מעדכנת את השפות הנתמכות לעיתים קרובות, כך שיכול להיות שזו רשימה חלקית בלבד.
-
אם לא תספקו את
languageCode
, ברירת המחדל של ה-API תהיהen
. אם מציינים קוד שפה לא תקין, ה-API יחזיר שגיאתINVALID_ARGUMENT
. - ממשק ה-API עושה כמיטב יכולתו כדי לספק כתובת רחוב שניתנת לקריאה גם למשתמשים וגם לתושבים המקומיים. כדי להשיג את המטרה הזו, המערכת מחזירה כתובות של רחובות בשפה המקומית, מתועתקות לסקריפט שהמשתמש יכול לקרוא במקרה הצורך, תוך שמירה על השפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרה מהרכיב הראשון.
- אם שם מסוים לא זמין בשפה המועדפת, ה-API משתמש בהתאמה הקרובה ביותר.
- לשפה המועדפת יש השפעה קטנה על קבוצת התוצאות שה-API בוחר להחזיר, ועל הסדר שבו הן מוחזרות. הקואורדינטות מפרשות קיצורים באופן שונה בהתאם לשפה, כמו הקיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת.
locationBias
מציין את האזור לחיפוש. המיקום הזה משמש כהטיה כך שיוחזר תוצאות מסביב למיקום שצוין, כולל תוצאות מחוץ לאזור שצוין.
אפשר לציין את
locationRestriction
או אתlocationBias
, אבל לא את שתי העמודות. אפשר להתייחס ל-locationRestriction
כאל ציון של האזור שבו התוצאות צריכות להיות, ו-locationBias
הוא ציון האזור שבו התוצאות צריכות להיות קרובות אבל הן יכולות להיות מחוץ לאזור.צריך לציין את האזור כאזור תצוגה מלבני או כעיגול.
מעגל מוגדר לפי נקודת המרכז והרדיוס במטרים. הרדיוס חייב להיות בין 0.0 ל-50,000.0, כולל. רדיוס ברירת המחדל הוא 0.0. למשל:
"locationBias": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } }
מלבן הוא אזור תצוגה של קווי אורך ורוחב, והוא מיוצג בשתי נקודות באלכסון עם מספר נמוך וגבוה באלכסון. הנקודה הנמוכה מסמנת את הפינה הדרום-מערבית של המלבן, והנקודה הגבוהה מייצגת את הפינה הצפון-מזרחית של המלבן.
אזור תצוגה נחשב לאזור סגור, כלומר הוא כולל את התחום שלו. גבולות הרוחב חייבים להיות בין -90 ל-90 מעלות כולל, וגבולות קו האורך צריכים להיות בין 180- ל-180 מעלות, כולל:
- אם
low
=high
, אזור התצוגה מורכב מהנקודה הזו. - אם הערך הוא
low.longitude
>high.longitude
, טווח קו האורך הפוך (אזור התצוגה חוצה את קו האורך 180 מעלות). - אם הערך של
low.longitude
הוא -180 מעלות ושלhigh.longitude
= 180 מעלות, אזור התצוגה כולל את כל קווי האורך. - אם הערך של
low.longitude
הוא 180 מעלות והערךhigh.longitude
הוא -180 מעלות, טווח קו האורך יהיה ריק. - אם
low.latitude
>high.latitude
, טווח קו הרוחב ריק.
צריך לאכלס גם את השדה 'נמוך' וגם את 'גבוה', והתיבה המיוצגת לא יכולה להיות ריקה. אזור תצוגה ריק יגרום לשגיאה.
לדוגמה, אזור התצוגה הזה כולל את כל העיר תל אביב:
"locationBias": { "rectangle": { "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } } }
- אם
locationRestriction
מציין את האזור לחיפוש. לא יוחזרו תוצאות מחוץ לאזור שצוין. הגדרת האזור כאזור תצוגה מלבני. אפשר לקרוא מידע נוסף על הגדרת אזור התצוגה בתיאור של
locationBias
.אפשר לציין את
locationRestriction
או אתlocationBias
, אבל לא את שתי העמודות. אפשר להתייחס ל-locationRestriction
כאל ציון של האזור שבו התוצאות צריכות להיות, ו-locationBias
הוא ציון האזור שבו התוצאות צריכות להיות קרובות אבל הן יכולות להיות מחוץ לאזור.-
max resultCount (הוצא משימוש)
מציין את מספר התוצאות (בין 1 ל-20) שיוצגו בכל דף. לדוגמה, אם תגדירו ערך של 5 ל-
maxResultCount
, תוחזר עד 5 תוצאות בדף הראשון. אם אפשר להחזיר תוצאות מהשאילתה, התגובה כוללתnextPageToken
, שאפשר להעביר לבקשה הבאה לקבלת גישה לדף הבא. evOptions
המדיניות מציינת פרמטרים לזיהוי מחברי טעינה זמינים של רכב חשמלי (EV) ותעריפי הטעינה.
connectorTypes
מסננים לפי סוג מחבר הטעינה לרכב חשמלי שזמין במקום. יתבצע סינון של מקום שלא תומך באף אחד מסוגי המחברים. הסוגים הנתמכים של מחברי טעינה לרכב חשמלי (EV) כוללים מטענים משולבים (AC ו-DC), מטענים של Tesla, מטענים שתואמים ל-GB/T (לטעינה מהירה לרכב חשמלי בסין) ומטענים לשקעי חשמל. מידע נוסף מופיע במאמרי העזרה.
minimumChargingRateKw
סינון מקומות לפי שיעור טעינה מינימלי של רכב חשמלי (EV) בקילוואט (קילוואט). המערכת תסנן מקומות שתעריף הטעינה שלהם נמוך מתעריף הטעינה המינימלי. לדוגמה, כדי למצוא עמדות טעינה לרכב חשמלי עם קצב טעינה של 10kW לפחות, אפשר להגדיר את הפרמטר הזה ל-'10'.
minRating
הגבלת התוצאות רק למשתמשים שדירוג המשתמשים הממוצע שלהם גדול מהגבלה זו או שווה לה. הערכים חייבים להיות בין 0.0 ל-5.0 (כולל) במרווחים של 0.5. לדוגמה: 0, 0.5, 1.0, ... , 5.0 כולל. הערכים מעוגלים כלפי מעלה עד ל-0.5 הקרוב ביותר. לדוגמה, ערך של 0.6 מבטל את כל התוצאות עם דירוג שנמוך מ-1.0.
openNow
אם הערך שלו הוא
true
, מוחזר רק המקומות שפתוחים בפני העסק בזמן שהשאילתה נשלחה. אם הערך הואfalse
, מוחזר כל העסקים ללא קשר לסטטוס הפתיחה. אם מגדירים את הפרמטר הזה ל-false
, יוחזרו מקומות שלא צוינו בהם שעות פתיחה במסד הנתונים של מקומות Google.pageSize
מציין את מספר התוצאות (בין 1 ל-20) שיוצגו בכל דף. לדוגמה, אם תגדירו ערך של 5 ל-
pageSize
, תוחזר עד 5 תוצאות בדף הראשון. אם אפשר להחזיר תוצאות מהשאילתה, התגובה כוללתnextPageToken
, שאפשר להעביר לבקשה הבאה לקבלת גישה לדף הבא.pageToken
מציינת את ה-
nextPageToken
בגוף התשובה של הדף הקודם.-
priceLevels
הגבלת החיפוש למקומות שמסומנים ברמות מחירים מסוימות. ברירת המחדל היא לבחור את כל רמות המחירים.
מציינים מערך של אחד או יותר מהערכים שהוגדרו על ידי
PriceLevel
.למשל:
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
rankPreference
מציין איך התוצאות מדורגות בתשובה על סמך סוג השאילתה:
- לשאילתה שמסווגת לפי קטגוריות, כמו "מסעדות בתל אביב",
ברירת המחדל היא
RELEVANCE
(דירוג התוצאות לפי רלוונטיות החיפוש). אפשר להגדיר אתrankPreference
לערךRELEVANCE
או לערךDISTANCE
(דירוג התוצאות לפי מרחק). - בשאילתה ללא קטגוריות, כמו 'Mountain View, CA', מומלץ
להשאיר את
rankPreference
לא מוגדר.
- לשאילתה שמסווגת לפי קטגוריות, כמו "מסעדות בתל אביב",
ברירת המחדל היא
regionCode
קוד האזור שמשמש לעיצוב התשובה, מוגדר כערך של קוד CLDR בן שני תווים. לפרמטר הזה יכולה להיות גם אפקט הטיה על תוצאות החיפוש. אין ערך ברירת מחדל.
אם שם המדינה בשדה
formattedAddress
בתשובה תואם ל-regionCode
, קוד המדינה לא יופיע ב-formattedAddress
. הפרמטר הזה לא משפיע עלadrFormatAddress
, שתמיד כולל את שם המדינה כשהוא זמין, או עלshortFormattedAddress
, שאף פעם לא כולל אותו.רוב קודי ה-CLDR זהים לקודי ISO 3166-1, עם כמה יוצאים מן הכלל. לדוגמה, הדומיין ccTLD של בריטניה הוא 'uk' (.co.uk) ואילו קוד ISO 3166-1 הוא 'gb' (טכנית לישות 'בריטניה וצפון אירלנד'). הפרמטר יכול להשפיע על התוצאות בהתאם לחוק הרלוונטי.
strictTypeFiltering
משתמשים בו עם הפרמטר
includedType
. אם המדיניות מוגדרת לערךtrue
, יוחזרו רק מקומות שתואמים לסוגים שצוינו ב-includeType
. אם הערך הוא False, ברירת המחדל היא התשובה יכולה להכיל מקומות שלא תואמים לסוגים שצוינו.
דוגמאות לחיפוש טקסט
חיפוש מקום לפי מחרוזת שאילתה
בדוגמה הבאה מוצגת בקשה של חיפוש טקסט עבור "מסעדה צמחונית חריפה בסידני, אוסטרליה":
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
שימו לב שהכותרת X-Goog-FieldMask
מציינת שהתגובה מכילה את שדות הנתונים הבאים: places.displayName,places.formattedAddress
.
לאחר מכן, התגובה תהיה בצורת:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, { "formattedAddress": "29 King St, Sydney NSW 2000, Australia", "displayName": { "text": "Peace Harmony", "languageCode": "en" } }, ... ] }
כדי להחזיר מידע נוסף, צריך להוסיף עוד סוגי נתונים למסכת השדות.
לדוגמה, כדי לכלול את סוג המסעדה ואת כתובת האינטרנט בתשובה, מוסיפים את places.types,places.websiteUri
:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \ 'https://places.googleapis.com/v1/places:searchText'
עכשיו התגובה תופיע בפורמט:
{ "places": [ { "types": [ "vegetarian_restaurant", "vegan_restaurant", "chinese_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "websiteUri": "http://www.motherchusvegetarian.com.au/", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "types": [ "vegan_restaurant", "thai_restaurant", "vegetarian_restaurant", "indian_restaurant", "italian_restaurant", "american_restaurant", "restaurant", "food", "point_of_interest", "establishment" ], "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia", "websiteUri": "http://www.veggosizzle.com.au/", "displayName": { "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney", "languageCode": "en" } }, ... ] }
סינון מקומות לפי רמת מחיר
משתמשים באפשרות priceLevel
כדי לסנן את התוצאות לפי מסעדות שמוגדרות כזולות או כיקרות במידה בינונית:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia", "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"] }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \ 'https://places.googleapis.com/v1/places:searchText'
בדוגמה הזו נעשה שימוש גם בכותרת X-Goog-FieldMask
כדי להוסיף את שדה הנתונים places.priceLevel
לתשובה, כך שהוא יהיה בצורה:
{ "places": [ { "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Mother Chu's Vegetarian Kitchen", "languageCode": "en" } }, { "formattedAddress": "115 King St, Newtown NSW 2042, Australia", "priceLevel": "PRICE_LEVEL_MODERATE", "displayName": { "text": "Green Mushroom", "languageCode": "en" } }, ... ] }
אפשר להוסיף עוד אפשרויות לצמצום החיפוש, כמו includedType
, minRating
, rankPreference
, openNow
ופרמטרים אחרים שמתוארים בקטע פרמטרים אופציונליים.
חיפוש מקומות באזור
כדי להגביל את החיפוש לאזור מסוים, משתמשים ב-locationRestriction
או ב-locationBias
, אבל לא בשתיהן. אפשר להתייחס ל-locationRestriction
כאל ציון של האזור שבו התוצאות צריכות להיות, ו-locationBias
כציון האזור שבו התוצאות צריכות להיות קרובות אבל יכולות להיות מחוץ לאזור.
בדוגמה הבאה מוצגת בקשה של חיפוש טקסט של 'אוכל צמחוני חריף' עם הטייה של עד 500 מטר מנקודה מסוימת בסן פרנסיסקו. הבקשה הזו מחזירה רק את 10 התוצאות הראשונות למקומות פתוחים.
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food", "openNow": true, "pageSize": 10, "locationBias": { "circle": { "center": {"latitude": 37.7937, "longitude": -122.3965}, "radius": 500.0 } }, }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \ 'https://places.googleapis.com/v1/places:searchText'
חיפוש עמדות טעינה לרכב חשמלי עם קצב טעינה מינימלי
אפשר להשתמש ב-minimumChargingRateKw
וב-connectorTypes
כדי לחפש מקומות עם מטענים זמינים שתואמים לרכב החשמלי שלך.
בדוגמה הבאה מוצגת בקשה למחברים של טעינה לרכב חשמלי (EV) מסוג 1 מסוג Tesla ו-J1772, שקצב הטעינה המינימלי שלהם במאונטיין ויו שבקליפורניה הוא 10 קילוואט. מתקבלות רק ארבע תוצאות.
curl -X POST -d '{ "textQuery": "EV Charging Station Mountain View", "pageSize": 4, "evOptions": { "minimumChargingRateKw": 10, "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"] } }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \ 'https://places.googleapis.com/v1/places:searchText'
הבקשה מחזירה את התגובה הבאה:
{ "places": [ { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 16, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 100, "count": 8, "availableCount": 5, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 2, "availableCount": 2, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 6, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 6, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 100, "count": 4, "availableCount": 3, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 350, "count": 2, "availableCount": 0, "outOfServiceCount": 2, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "EVgo Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 5, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_J1772", "maxChargeRateKw": 3.5999999046325684, "count": 1, "availableCount": 0, "outOfServiceCount": 1, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CHADEMO", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" }, { "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1", "maxChargeRateKw": 50, "count": 2, "availableCount": 0, "outOfServiceCount": 0, "availabilityLastUpdateTime": "2024-01-10T19:10:00Z" } ] } }, { "displayName": { "text": "Electric Vehicle Charging Station", "languageCode": "en" }, "evChargeOptions": { "connectorCount": 10, "connectorAggregation": [ { "type": "EV_CONNECTOR_TYPE_OTHER", "maxChargeRateKw": 210, "count": 10 } ] } } ] }
ציון מספר התוצאות שיוחזרו בכל דף
משתמשים בפרמטר pageSize
כדי לציין מספר תוצאות שיחזרו בכל דף. הפרמטר nextPageToken
בגוף התגובה מספק אסימון שאפשר להשתמש בו בקריאות הבאות כדי לגשת לדף התוצאות הבא.
בדוגמה הבאה מוצגת בקשה ל "פיצה בתל אביב" שמוגבלת ל-5 תוצאות בכל דף:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5 }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJifIePKtZwokRVZ-UdRGkZzs" }, { "id": "ChIJPxPd_P1YwokRfzLhSiACEoU" }, { "id": "ChIJrXXKn5NZwokR78g0ipCnY60" }, { "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE" }, { "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw" } ], "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }
כדי לגשת לדף התוצאות הבא, צריך להשתמש ב-pageToken
כדי להעביר את הפקודה nextPageToken
בגוף הבקשה:
curl -X POST -d '{ "textQuery": "pizza in New York", "pageSize": 5, "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \ -H "X-Goog-FieldMask: places.id,nextPageToken" \ 'https://places.googleapis.com/v1/places:searchText'
{ "places": [ { "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw" }, { "id": "ChIJjaD94kFZwokR-20CXqlpy_4" }, { "id": "ChIJ6ffdpJNZwokRmcafdROM5q0" }, { "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM" }, { "id": "ChIJ8164qwFZwokRhplkmhvq1uE" } ], "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c" }
רוצה לנסות?
באמצעות API Explorer תוכלו לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת אפשרויות ה-API.
בצד שמאל של הדף, בוחרים בסמל ה-API .
אפשר להרחיב את האפשרות Show default parameters (הצגת פרמטרים סטנדרטיים) ולהגדיר את הפרמטר
fields
למסכת השדות.אפשר לערוך את גוף הבקשה.
לוחצים על הלחצן Execute. בתיבת הדו-שיח שקופצת, בוחרים את החשבון שבו רוצים להשתמש לביצוע הבקשה.
בחלונית של API Explorer, לוחצים על סמל ההרחבה כדי להרחיב את חלון ה-API Explorer.