‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

השלמה אוטומטית של שאילתות (דור קודם)

מפתחים באזור הכלכלי האירופי (EEA)

הערה: ספריות בצד השרת ובצד הלקוח

‫Places API זמין גם עם לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google. ‫Places API וספריות הלקוח מיועדים לשימוש באפליקציות בצד השרת.

אם אתם מפתחים אפליקציה בצד הלקוח, כדאי לעיין במאמרים בנושא Places SDK ל-Android (הגרסה החדשה), Places SDK ל-iOS (הגרסה החדשה) וספריית המקומות ב-Maps JavaScript API.

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

בקשות של Query Autocomplete (דור קודם)

‫Query Autocomplete (מדור קודם) הוא חלק מ-Places API (מדור קודם), והוא חולק מפתח API ומכסה עם Places API (מדור קודם).

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

בקשה להשלמה אוטומטית של שאילתה (מדור קודם) היא כתובת URL מסוג HTTP בפורמט הבא:

https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters

כאשר output יכול להיות json או xml.

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

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

קלט

מחרוזת הטקסט שרוצים לחפש. שירות ההשלמה האוטומטית למקומות יחזיר התאמות אפשריות על סמך המחרוזת הזו, ויסדר את התוצאות לפי הרלוונטיות המשוערת שלהן.

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

language

השפה שבה התוצאות יוחזרו.

כאן אפשר לעיין ברשימת השפות הנתמכות. ‫Google מעדכנת לעיתים קרובות את השפות הנתמכות, כך שהרשימה הזו לא בהכרח מלאה.
אם לא מציינים את language, ה-API מנסה להשתמש בשפה המועדפת שצוינה בכותרת Accept-Language.
ה-API מנסה לספק כתובת רחוב שקריאה גם למשתמש וגם למקומיים. כדי להשיג את המטרה הזו, הוא מחזיר כתובות רחוב בשפה המקומית, עם תעתיק לכתב שהמשתמש יכול לקרוא במידת הצורך, תוך התחשבות בשפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרת לפי הרכיב הראשון.
אם השם לא זמין בשפה המועדפת, ה-API משתמש בהתאמה הקרובה ביותר.
השפה המועדפת משפיעה קצת על קבוצת התוצאות שה-API בוחר להחזיר ועל הסדר שבו הן מוחזרות. הכלי להמרת כתובות לקואורדינטות מפרש קיצורים באופן שונה בהתאם לשפה, למשל קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת. לדוגמה, utca ו-tér הן מילים נרדפות לרחוב בהונגרית.

location

מגדיר נקודה, כקואורדינטות latitude,longitude, שסביבה יתבצע החיפוש. שירות Places משתמש במיקום כדי להטות את החיפוש כך שיוצגו תוצאות באזור שמוגדר על ידי location ו-radius. יכול להיות שיוצגו תוצאות מחוץ לאזור שהוגדר.

יכול להיות שהפרמטר location יוחלף אם הפרמטר query מכיל מיקום מפורש, כמו Market in Barcelona. שימוש במירכאות סביב השאילתה עשוי גם להשפיע על המשקל שניתן ל-location ול-radius.

היסט

המיקום של התו האחרון במונח הקלט שבו השירות משתמש כדי להתאים תחזיות. לדוגמה, אם הקלט הוא Google וההיסט הוא 3, השירות יתאים ל-Goo. המחרוזת שנקבעת לפי ההיסט מושווית למילה הראשונה במונח הקלט בלבד. לדוגמה, אם המונח שהוזן הוא Google abc וההיסט הוא 3, השירות ינסה להתאים ל-Goo abc. אם לא מציינים היסט, השירות ישתמש בכל המונח. בדרך כלל, צריך להגדיר את ההיסט למיקום של סמן הטקסט.

רדיוס

מגדיר את המרחק (במטרים) שבו יוחזרו תוצאות של מקומות. אפשר להטות את התוצאות למעגל מסוים על ידי העברת הפרמטרים location ו-radius. כך שירות Places יקבל הוראה להעדיף להציג תוצאות בתוך המעגל הזה, אבל עדיין יכול להיות שיוצגו תוצאות מחוץ לאזור שהוגדר.

הרדיוס יוגבל באופן אוטומטי לערך מקסימלי בהתאם לסוג החיפוש ולפרמטרים אחרים.

השלמה אוטומטית: 50,000 מטרים
חיפוש בסביבה:
- עם keyword או name: ‏50,000 מטרים
- בלי keyword או name
  - עד 50,000 מטרים, מותאם באופן דינמי על סמך צפיפות האזור, ללא קשר לפרמטר rankby.
  - כשמשתמשים ב-rankby=distance, הפרמטר radius לא יתקבל ותתקבל השגיאה INVALID_REQUEST.
השלמה אוטומטית של שאילתות: 50,000 מטרים
חיפוש טקסט: 50,000 מטרים

דוגמאות להשלמה אוטומטית של שאילתות (גרסה קודמת)

כתובת URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

בקשה "פיצה ליד פרי", עם תוצאות בצרפתית:

כתובת URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &language=fr
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'

שימו לב שצריך להחליף את מפתח ה-API בדוגמאות האלה במפתח שלכם.

תגובה של השלמה אוטומטית של שאילתה (מדור קודם)

התשובות של Query Autocomplete (Legacy)‎ מוחזרות בפורמט שמצוין בדגל output בנתיב של בקשת כתובת ה-URL. התוצאות שבהמשך מוחזרות לשאילתה עם הפרמטרים הבאים:

כתובת URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

JSON

{
  "predictions":
    [
      {
        "description": "pizza near Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris" },
            { "offset": 18, "value": "France" },
          ],
      },
      {
        "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Pari Chowk" },
            { "offset": 23, "value": "NRI City" },
            { "offset": 33, "value": "Omega II" },
            { "offset": 43, "value": "Noida" },
            { "offset": 50, "value": "Uttar Pradesh" },
            { "offset": 65, "value": "India" },
          ],
      },
      {
        "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 16 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Disneyland Park" },
            { "offset": 28, "value": "Disneyland Drive" },
            { "offset": 46, "value": "Anaheim" },
            { "offset": 55, "value": "CA" },
            { "offset": 59, "value": "USA" },
          ],
      },
      {
        "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 30 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" },
            { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" },
            { "offset": 83, "value": "Paris" },
            { "offset": 90, "value": "France" },
          ],
      },
      {
        "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris Beauvais Airport" },
            { "offset": 35, "value": "Route de l'Aéroport" },
            { "offset": 56, "value": "Tillé" },
            { "offset": 63, "value": "France" },
          ],
      },
    ],
  "status": "OK",
}

XML

      
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>pizza near Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>France</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Pari Chowk</value>
   <offset>11</offset>
  </term>
  <term>
   <value>NRI City</value>
   <offset>23</offset>
  </term>
  <term>
   <value>Omega II</value>
   <offset>33</offset>
  </term>
  <term>
   <value>Noida</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Uttar Pradesh</value>
   <offset>50</offset>
  </term>
  <term>
   <value>India</value>
   <offset>65</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Disneyland Park</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Disneyland Drive</value>
   <offset>28</offset>
  </term>
  <term>
   <value>Anaheim</value>
   <offset>46</offset>
  </term>
  <term>
   <value>CA</value>
   <offset>55</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>59</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>22</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>16</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Cathédrale Notre-Dame de Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Parvis Notre-Dame - place Jean-Paul-II</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>83</offset>
  </term>
  <term>
   <value>France</value>
   <offset>90</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>36</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>30</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris Beauvais Airport</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Route de l'Aéroport</value>
   <offset>35</offset>
  </term>
  <term>
   <value>Tillé</value>
   <offset>56</offset>
  </term>
  <term>
   <value>France</value>
   <offset>63</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

כששירות Places מחזיר תוצאות JSON מחיפוש, הוא ממקם אותן במערך predictions. גם אם השירות לא מחזיר תוצאות (למשל, אם location מרוחק), הוא עדיין מחזיר מערך predictions ריק. תגובות XML מכילות אפס רכיבי <prediction> או יותר.

PlacesQueryAutocompleteResponse

שדה	חובה	סוג	תיאור
`predictions`	חובה	מערך<PlaceAutocompletePrediction>	מכיל מערך של חיזויים. מידע נוסף זמין במאמר בנושא PlaceAutocompletePrediction.
`status`	חובה	PlacesAutocompleteStatus	מכיל את סטטוס הבקשה, ועשוי להכיל מידע על תוצאות ניפוי הבאגים שיעזור לכם להבין למה הבקשה נכשלה. מידע נוסף זמין במאמר PlacesAutocompleteStatus.
`error_message`	אופציונלי	מחרוזת	כשהשירות מחזיר קוד סטטוס שונה מ-`OK`, יכול להיות שיהיה שדה `error_message` נוסף באובייקט התגובה. השדה הזה מכיל מידע מפורט יותר על הסיבות לקוד הסטטוס שניתן. השדה הזה לא תמיד מוחזר, והתוכן שלו עשוי להשתנות.
`info_messages`	אופציונלי	מערך<string>	כשהשירות מחזיר מידע נוסף על מפרט הבקשה, יכול להיות שיהיה שדה `info_messages` נוסף באובייקט התגובה. השדה הזה מוחזר רק בבקשות שהצליחו. יכול להיות שהשדה לא תמיד יוחזר, והתוכן שלו עשוי להשתנות.

PlacesAutocompleteStatus

קודי סטטוס שהוחזרו על ידי השירות.

‫OK, שמציין שבקשת ה-API בוצעה בהצלחה.
‫ZERO_RESULTS, שמציין שהחיפוש הצליח אבל לא הניב תוצאות. זה יכול לקרות אם החיפוש הועבר לגבולות במיקום מרוחק.
INVALID_REQUEST, שמציין שבקשת ה-API לא תקינה, בדרך כלל בגלל שחסר הפרמטר input.
OVER_QUERY_LIMIT שמציינים את אחד מהדברים הבאים:
- חרגתם ממגבלות ה-QPS.
- החיוב לא הופעל בחשבון שלכם.
- חרגתם מהקרדיט החודשי בסך 200 $או ממכסת השימוש שהגדרתם בעצמכם.
- אמצעי התשלום שסופק כבר לא תקף (לדוגמה, פג התוקף של כרטיס האשראי).
בשאלות הנפוצות בנושא מפות מוסבר איך לפתור את השגיאה הזו.
REQUEST_DENIED, שמציין שהבקשה נדחתה, בדרך כלל מהסיבות הבאות:
- בבקשה חסר מפתח API.
- הפרמטר key לא תקין.
‫UNKNOWN_ERROR מציין שגיאה לא ידועה.

כששירות Places מחזיר תוצאות JSON מחיפוש, הוא ממקם אותן במערך predictions. גם אם השירות לא מחזיר תוצאות (למשל, אם ה-location מרוחק), הוא עדיין מחזיר מערך predictions ריק. תשובות ב-XML מכילות אפס רכיבי <prediction> או יותר.

PlaceAutocompletePrediction

שדה	חובה	סוג	תיאור
`description`	חובה	מחרוזת	מכיל את השם הקריא לאנשים של התוצאה שהוחזרה. בתוצאות של `establishment`, בדרך כלל מדובר בשם העסק. התוכן הזה מיועד לקריאה כמו שהוא. אין לנתח באופן פרוגרמטי את הכתובת המעוצבת.
`matched_substrings`	חובה	מערך<PlaceAutocompleteMatchedSubstring>	רשימה של מחרוזות משנה שמתארות את המיקום של המונח שהוזן בטקסט של תוצאת החיזוי, כדי שאפשר יהיה להדגיש את המונח אם רוצים. מידע נוסף זמין במאמר בנושא PlaceAutocompleteMatchedSubstring.
`structured_formatting`	חובה	PlaceAutocompleteStructuredFormat	מספק טקסט בפורמט מוגדר מראש שאפשר להציג בתוצאות ההשלמה האוטומטית. התוכן הזה מיועד לקריאה כמו שהוא. אין לנתח באופן פרוגרמטי את הכתובת המעוצבת. מידע נוסף זמין במאמר PlaceAutocompleteStructuredFormat.
`terms`	חובה	מערך<PlaceAutocompleteTerm>	מכיל מערך של מונחים שמזהים כל חלק בתיאור שמוחזר (בדרך כלל, חלק בתיאור מסתיים בפסיק). לכל רשומה במערך יש שדה `value` שמכיל את הטקסט של המונח, ושדה `offset` שמגדיר את מיקום ההתחלה של המונח בתיאור, שנמדד בתווי Unicode. מידע נוסף זמין במאמר PlaceAutocompleteTerm.
`distance_meters`	אופציונלי	מספר שלם	המרחק בקו ישר במטרים מנקודת המוצא. השדה הזה מוחזר רק לבקשות שבוצעו עם `origin`.
`place_id`	אופציונלי	מחרוזת	מזהה טקסטואלי שמזהה מקום באופן ייחודי. כדי לאחזר מידע על המקום, צריך להעביר את המזהה הזה בשדה placeId של בקשת Places API. למידע נוסף על מזהי מקומות, קראו את הסקירה הכללית בנושא מזהי מקומות.
`reference`	אופציונלי	מחרוזת	השיטה `reference` הוצאה משימוש. ראו place_id.
`types`	אופציונלי	מערך<string>	מכיל מערך של סוגים שרלוונטיים למקום הזה. לדוגמה: `[ "political", "locality" ]` או `[ "establishment", "geocode", "beauty_salon" ]`. המערך יכול להכיל כמה ערכים. מידע נוסף על סוגי מקומות

PlaceAutocompleteMatchedSubstring

שדה	חובה	סוג	תיאור
`length`	חובה	number	אורך מחרוזת המשנה התואמת בטקסט של תוצאת החיזוי.
`offset`	חובה	number	מיקום ההתחלה של מחרוזת המשנה התואמת בטקסט של תוצאת החיזוי.

PlaceAutocompleteStructuredFormat

שדה	חובה	סוג	תיאור
`main_text`	חובה	מחרוזת	מכיל את הטקסט הראשי של החיזוי, בדרך כלל שם המקום.
`main_text_matched_substrings`	חובה	מערך<PlaceAutocompleteMatchedSubstring>	מכיל מערך עם הערך `offset` ו-`length`. הם מתארים את המיקום של המונח שהוזן בטקסט של תוצאת החיזוי, כדי שאפשר יהיה להדגיש את המונח אם רוצים. מידע נוסף זמין במאמר בנושא PlaceAutocompleteMatchedSubstring.
`secondary_text`	אופציונלי	מחרוזת	מכיל את הטקסט המשני של החיזוי, בדרך כלל המיקום של המקום.
`secondary_text_matched_substrings`	אופציונלי	מערך<PlaceAutocompleteMatchedSubstring>	מכיל מערך עם הערך `offset` ו-`length`. הם מתארים את המיקום של המונח שהוזן בטקסט של תוצאת החיזוי, כדי שאפשר יהיה להדגיש את המונח אם רוצים. מידע נוסף זמין במאמר בנושא PlaceAutocompleteMatchedSubstring.

PlaceAutocompleteTerm

שדה	חובה	סוג	תיאור
`offset`	חובה	number	מגדיר את מיקום ההתחלה של המונח הזה בתיאור, נמדד בתווי Unicode
`value`	חובה	מחרוזת	הטקסט של המונח.

השלמה אוטומטית של שאילתות (דור קודם) קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

בקשות של Query Autocomplete (דור קודם)

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

קלט

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

language

location

היסט

רדיוס

דוגמאות להשלמה אוטומטית של שאילתות (גרסה קודמת)

כתובת URL

curl

כתובת URL

curl

תגובה של השלמה אוטומטית של שאילתה (מדור קודם)

כתובת URL

curl

JSON

XML

PlacesQueryAutocompleteResponse

predictions

status

error_message

info_messages

PlacesAutocompleteStatus

PlaceAutocompletePrediction

description

matched_substrings

structured_formatting

terms

distance_meters

place_id

reference

types

PlaceAutocompleteMatchedSubstring

length

offset

PlaceAutocompleteStructuredFormat

main_text

main_text_matched_substrings

secondary_text

secondary_text_matched_substrings

PlaceAutocompleteTerm

offset

value

השלמה אוטומטית של שאילתות (דור קודם)

`predictions`

`status`

`error_message`

`info_messages`

`description`

`matched_substrings`

`structured_formatting`

`terms`

`distance_meters`

`place_id`

`reference`

`types`

`length`

`offset`

`main_text`

`main_text_matched_substrings`

`secondary_text`

`secondary_text_matched_substrings`

`offset`

`value`