דף זה תורגם על ידי Cloud Translation API.

חיפוש טקסט (חדש)

חיפוש טקסט (חדש) מחזיר מידע על קבוצה של מקומות על סמך מחרוזת, לדוגמה: "פיצה בתל אביב", "חנויות נעליים ליד אטווה" או "הרצל 123". בתגובה, השירות מציג רשימה של מקומות שתואמים למחרוזת הטקסט וכל הטיה של המיקום שהוגדרה.

השירות שימושי במיוחד ליצירת שאילתות לא חד-משמעיות של כתובות במערכת אוטומטית, ורכיבים של המחרוזת שאינם כתובות יכולים להתאים לעסקים וגם לכתובות. דוגמאות לשאילתות כתובת לא חד-משמעיות: כתובות בפורמט לא תקין או בקשות שכוללות רכיבים שאינם כתובת, כמו שמות עסקים. בקשות כמו שתי הדוגמאות הראשונות בטבלה הבאה עשויות להחזיר אפס תוצאות, אלא אם מוגדר מיקום מסוים – כמו אזור, הגבלה לפי מיקום או הטיית מיקום.

"10 High Street, UK" או "123Main Street, US"	מספר "רחובות" בבריטניה; מספר "רחובות ראשיים" בארה"ב. השאילתה לא מחזירה תוצאות רצויות, אלא אם מוגדרת הגבלת מיקום.
"ChainRestaurant ניו יורק"	מספר סניפים של "ChainRestaurant" בניו יורק, ללא רחוב או אפילו שם רחוב.
"10 High Street, Escher UK" או "123 הדרך הראשית, חיפה"	רק "רחוב גבוה" אחד בעיר אשר בבריטניה; רק "רחוב ראשי" אחד בעיר פלסנטון בארה"ב.
"UniqueRestaurantName New York"	רק בית עסק אחד בשם זה בניו יורק; אין צורך בכתובת כדי להבדיל בין אלה.
"פיצריות בתל אביב"	השאילתה הזו מכילה את הגבלת המיקום שלה, ו "מסעדות פיצה" הוא סוג מקום מוגדר היטב. היא מחזירה מספר תוצאות.
"+1 514-670-8700"	השאילתה הזו מכילה מספר טלפון. הוא יחזיר מספר תוצאות עבור מקומות שמשויכים למספר הטלפון הזה. הערה: כדי לקבל את התוצאות הטובות ביותר כשמחפשים מספר טלפון, יש לכלול את קוד המדינה ואחריה רווח, ולהגדיר את הפרמטר `regionCode` כך שיתאים לקוד המדינה.

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'

תשובות מסוג 'חיפוש טקסט' (חדש)

חיפוש טקסט (חדש) מחזיר אובייקט JSON כתגובה. בתשובה:

המערך places מכיל את כל המקומות התואמים.
כל מקום במערך מיוצג על ידי אובייקט Place. האובייקט Place מכיל מידע מפורט על מקום אחד.
השדה FieldMask שהועבר בבקשה מציין את רשימת השדות שהוחזרו באובייקט Place.

אובייקט ה-JSON המלא מופיע בצורה הבאה:

{
  "places": [
    {
      object (Place)
    }
  ]
}

פרמטרים נדרשים

FieldMask

כדי לציין את רשימת השדות שיוחזרו בתגובה, יוצרים אנונימיזציה של שדות התשובה. מעבירים את המסכה של שדה התגובה לשיטה באמצעות הפרמטר של כתובת האתר $fields או fields, או באמצעות כותרת ה-HTTP X-Goog-FieldMask. אין בתשובה רשימת ברירת מחדל של שדות שהוחזרו. אם משמיטים את מסכת השדות, השיטה מחזירה שגיאה.

מומלץ לבצע אנונימיזציה של שדות כדי שלא תבקשו נתונים מיותרים, וכך להימנע מזמן עיבוד ומחיובים מיותרים.

מציינים רשימה מופרדת בפסיקים של סוגי נתוני מקומות שיש להחזיר. לדוגמה, כדי לאחזר את השם המוצג ואת הכתובת של המקום.
```
X-Goog-FieldMask: places.displayName,places.formattedAddress
```
הערה: אסור להשתמש ברווחים באף מקום ברשימת השדות.

כדי לאחזר את כל השדות, צריך להשתמש בפונקציה *.
```
X-Goog-FieldMask: *
```
התו הכללי לחיפוש '*' בוחר את כל השדות. עם זאת, למרות שמותר להשתמש בתו הכללי הזה בפיתוח, Google לא ממליצה להשתמש במסכה של שדה התגובה עם התו הכללי לחיפוש (*) בסביבת הייצור, בגלל הכמות הגדולה של הנתונים שאפשר להחזיר.

הנחיות נוספות לשימוש ב-places.iconMaskBaseUri וב-places.iconBackgroundColor זמינות בקטע סמלי מקומות.

צריך לציין אחד או יותר מהשדות הבאים:
- השדות הבאים מפעילים את המק"ט של חיפוש טקסט (מזהה בלבד):
  places.id, places.name^*
  
  ^* השדה places.name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. משתמשים ב-places.displayName כדי לגשת לשם הטקסט של המקום.
- השדות הבאים מפעילים את המק"ט של חיפוש טקסט (בסיסי):
  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, {18places.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.liveMusicplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
textQuery

מחרוזת הטקסט שבה יש לחפש, לדוגמה: "restaurant", "רחוב ראשי 123" או "המקום הטוב ביותר לביקור בתל אביב". ה-API מחזיר התאמות אפשריות על סמך המחרוזת הזו ומסדר את התוצאות לפי הרלוונטיות שלהן.

פרמטרים אופציונליים

includedType

מגבילה את התוצאות למקומות שתואמים לסוג שצוין, כפי שהוגדר בטבלה א. ניתן לציין סוג אחד בלבד. למשל:
- "includedType":"bar"
- "includedType":"pharmacy"
הערה: הערכים בטבלה ב' מוחזרים רק בתגובה. לא ניתן להשתמש בערכים בטבלה ב' כמסנן.
languageCode

השפה שבה יוחזרו התוצאות.
- כאן אפשר לעיין ברשימת השפות הנתמכות. Google מעדכנת לעיתים קרובות את השפות הנתמכות, ולכן ייתכן שהרשימה הזו חלקית.
- אם לא מציינים languageCode, ברירת המחדל של ה-API היא en. אם מציינים קוד שפה לא חוקי, ה-API יחזיר את השגיאה INVALID_ARGUMENT.
- ה-API עושה כמיטב יכולתו כדי לספק כתובת רחוב שתהיה קריאה גם למשתמש וגם למקומיים. כדי להשיג את המטרה הזו, הפונקציה מחזירה כתובות רחוב בשפה המקומית, ומתועתקות לסקריפט שהמשתמש יכול לקרוא במידת הצורך, תוך שימוש בשפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרת מהרכיב הראשון.
- אם שם לא זמין בשפה המועדפת, ה-API ישתמש בהתאמה הקרובה ביותר.
- לשפה המועדפת יש השפעה קטנה על קבוצת התוצאות שה-API בוחר להחזיר ועל הסדר שבו הן מוחזרות. המקודד מפרש קיצורים באופן שונה בהתאם לשפה, כמו קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות חוקיות בשפה אחת, אך לא בשפה אחרת.
locationBias

מציין אזור לחיפוש. המיקום הזה משמש כהטיה, כלומר אפשר להחזיר תוצאות מסביב למיקום שצוין, כולל תוצאות מחוץ לאזור שצוין.

אפשר לציין locationRestriction או locationBias, אבל לא את שתיהן. אפשר להתייחס ל-locationRestriction כאל האזור שבו התוצאות חייבות להיות ועל locationBias לציון האזור שהתוצאות חייבות להיות בקרבתו, אבל יכולות להיות מחוץ לאזור.

הערה: אם משמיטים את locationBias וגם locationRestriction, ה-API משתמש בתעדוף לפי IP כברירת מחדל. בתעדוף לפי IP, ה-API משתמש בכתובת ה-IP של המכשיר כדי להטות את התוצאות.

הערה: אפשר לבטל את הפרמטר locationBias אם textQuery מכיל מיקום מפורש כמו Market in Barcelona. במקרה כזה, המערכת תתעלם מ-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 לציון האזור שהתוצאות חייבות להיות בקרבתו, אבל יכולות להיות מחוץ לאזור.

הערה: אם משמיטים את locationBias וגם locationRestriction, ה-API משתמש בתעדוף לפי IP כברירת מחדל. בתעדוף לפי IP, ה-API משתמש בכתובת ה-IP של המכשיר כדי להטות את התוצאות.
maxResultCount

מציין את המספר המקסימלי של תוצאות של מקומות שיוחזרו. חייב להיות בין 1 ל-20 (ברירת מחדל) כולל.
evOptions

מציין פרמטרים לזיהוי מחברים זמינים לטעינה של רכב חשמלי (EV) וקצבי טעינה.
- connectorTypes
  
  מסננים לפי סוג המחבר לטעינה של הרכב החשמלי שזמין במקום. מקום שלא תומך באף אחד מסוגי המחברים יסונן. הסוגים הנתמכים של מחברים לטעינה חשמלית כוללים מטענים משולבים (AC ו-DC), מטעני Tesla, מטענים תואמי GB/T (לטעינה מהירה של כלי רכב חשמליים בסין) ומטענים לשקעים בקיר. מידע נוסף זמין במסמכי התיעוד.
- minimumChargingRateKw
  
  סינון מקומות לפי קצב טעינה מינימלי של רכב חשמלי בקילוואט (kW). מקומות שהתעריף שלהם נמוך משיעור הטעינה המינימלי יסוננו. לדוגמה, כדי למצוא מטענים לרכב חשמלי עם קצב טעינה של 10 kW לפחות, אפשר להגדיר את הפרמטר הזה ל-'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.
priceLevels

הגבלת החיפוש למקומות שמסומנים ברמות מחיר מסוימות. ברירת המחדל היא לבחור את כל רמות המחירים.

צריך לציין מערך של ערך אחד או יותר שמוגדר על ידי PriceLevel.

הערה: אסור להשתמש ב-PRICE_LEVEL_FREE במסגרת בקשה. הוא משמש רק לאכלוס התשובה.

למשל:
```
"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

בשימוש עם הפרמטר includeType. אם המדיניות מוגדרת לערך 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 לציון האזור שהתוצאות חייבות להיות קרובות אליו, אבל הן יכולות להיות מחוץ לאזור.

הערה: כשמשתמשים ב-locationBias, אפשר לציין את האזור כאזור תצוגה מלבני או כעיגול. ב-locationRestriction, אפשר לציין את האזור כאזור תצוגה מלבני.

בדוגמה הבאה מוצגת בקשה של 'חיפוש טקסט' עבור 'אוכל צמחוני חריף', שהטירגוט שלה הוא בטווח של 500 מטר מנקודה מסוימת באזור הדאונטאון של סן פרנסיסקו. בקשה זו מחזירה רק את 10 התוצאות הראשונות של מקומות פתוחים.

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "openNow": true,
  "maxResultCount": 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 תוכלו לחפש מקומות עם מטענים זמינים שתואמים לרכב החשמלי שלכם.

בדוגמה הבאה מוצגת בקשה למחברי טעינה לרכב חשמלי מסוג Tesla ו-J1772 מסוג 1, עם קצב טעינה מינימלי של 10 kW במאונטיין ויו שבקליפורניה. מוחזרות רק ארבע תוצאות.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "maxResultCount": 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
          }
        ]
      }
    }
  ]
}

רוצה לנסות?

תוכלו לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות של API.

לוחצים על סמל ה-API בצד ימין של הדף.
אפשר להרחיב את האפשרות הצג פרמטרים סטנדרטיים ולהגדיר את הפרמטר fields כמסכת שדות.
אפשר לערוך את גוף הבקשה.
לוחצים על הלחצן ביצוע. בתיבת הדו-שיח הקופצת, בוחרים את החשבון שבו רוצים להשתמש לשליחת הבקשה.
בחלונית של API Explorer לוחצים על סמל ההרחבה כדי להרחיב את החלון של API Explorer.

חיפוש טקסט (חדש)

בקשות לחיפוש טקסט

תשובות מסוג 'חיפוש טקסט' (חדש)

פרמטרים נדרשים

FieldMask

textQuery

פרמטרים אופציונליים

includedType

languageCode

locationBias

locationRestriction

maxResultCount

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

priceLevels

rankPreference

regionCode

strictTypeFiltering