חיפוש טקסט (חדש) מחזירה מידע על קבוצה של מקומות לפי מחרוזת. לדוגמה "פיצה בתל אביב" או "חנויות נעליים ליד אוטווה" או "הרצל 123". בתשובה של השירות יש רשימה של מקומות שתואמים למחרוזת הטקסט ולכל מיקום שהוגדרה.
השירות שימושי במיוחד ליצירת שאילתות עם כתובות מעורפלות במערכת אוטומטית, ורכיבים שאינם כתובות של המחרוזת עשויים להתאים עסקים וגם כתובות. דוגמאות לשאילתות כתובת לא ברורות: כתובות או בקשות שהפורמט שלהן לא תקין, או בקשות שכוללות רכיבים שאינם כתובות, כשמות עסק. בקשות כמו שתי הדוגמאות הראשונות בטבלה הבאה עשוי להחזיר אפס תוצאות, אלא אם מיקום – כמו אזור, מיקום מוגדרת הגבלה, או הטיית מיקום.
"הרצל 10, בריטניה" או "הרצל 12, ישראל" | מספר שירותי "היי סטריט" בבריטניה; מספר "רחובות ראשיים" בארה"ב. השאילתה לא מחזירה תוצאות רצויות, אלא אם הוגדרה הגבלת מיקום הוגדרה. |
"ChainRestaurant ניו יורק" | כמה "ChainRestaurant" מיקומים בניו יורק; אין כתובת או אפילו שם הרחוב. |
" 10 High Street, Escher UK" או "הרצל 12, ישראל" | רק רחוב אחד ראשי בעיר אשר בבריטניה; רק "רחוב ראשי" אחד בעיר פלסנטון שבארה"ב, קליפורניה. |
"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
כדי לציין את רשימת השדות שיוחזרו בתשובה, צריך ליצור response field mask. מעבירים את אנונימיזציה של שדות התגובה ל-method באמצעות הפרמטר של כתובת האתר
$fields
אוfields
, או באמצעות כותרת ה-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.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.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 ל-50000.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
מסננים לפי סוג מחבר הטעינה לרכב חשמלי שזמין במקום. א' יתבצע סינון של מקום שאינו תומך באף אחד מסוגי המחברים החוצה. הסוגים הנתמכים של מחברי טעינה לרכב חשמלי כוללים שילוב משולב (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
, החזרת כל העסקים ללא קשר לסטטוס הפתיחה. מקומות שלא צוינו עבורם שעות פתיחה במסד הנתונים של מקומות Google מוחזר אם הגדרתם את הפרמטר הזה ל-false
.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
כדי לכלול את
סוג המסעדה וכתובת האינטרנט
response:
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 ו-J1772 מחברים עם קצב טעינה מינימלי של 10kW במאונטיין ויו שבקליפורניה. רק ארבע תוצאות מוחזרות.
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,
, בצד שמאל של הדף.
אפשר להרחיב את הקטע הצגת פרמטרים רגילים ולהגדיר את השדה
fields
לפרמטר הפרמטר mask.אפשר לערוך את גוף הבקשה.
לוחצים על הלחצן Execute. בתיבת הדו-שיח הקופצת, בוחרים את החשבון שרוצים להשתמש בהן כדי לשלוח את הבקשה.
בחלונית של API Explorer לוחצים על סמל ההרחבה.
, כדי להרחיב את החלון של API Explorer.