Method: places.autocomplete

{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}

object (Viewport)

אזור תצוגה שמוגדר לפינה צפון מזרחית ופינה דרום-מערבית.

object (Circle)

מעגל שמוגדר לפי נקודת מרכז ורדיוס.

{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}

object (Viewport)

אזור תצוגה שמוגדר לפינה צפון מזרחית ופינה דרום-מערבית.

object (Circle)

מעגל שמוגדר לפי נקודת מרכז ורדיוס.

{

  // Union field kind can be only one of the following:
  "placePrediction": {
    object (PlacePrediction)
  },
  "queryPrediction": {
    object (QueryPrediction)
  }
  // End of list of possible types for union field kind.
}

object (PlacePrediction)

חיזוי לגבי מקום.

object (QueryPrediction)

חיזוי לשאילתה.

{
  "place": string,
  "placeId": string,
  "text": {
    object (FormattableText)
  },
  "structuredFormat": {
    object (StructuredFormat)
  },
  "types": [
    string
  ],
  "distanceMeters": integer
}

string

שם המשאב של המקום המוצע. ניתן להשתמש בשם הזה בממשקי API אחרים שמקבלים שמות של מקומות.

string

המזהה הייחודי של המקום המוצע. אפשר להשתמש במזהה הזה בממשקי API אחרים שמקבלים מזהי מקומות.

object (FormattableText)

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

text מומלץ למפתחים שרוצים להציג רק רכיב אחד של ממשק המשתמש. מפתחים שרוצים להציג שני אלמנטים נפרדים של ממשק המשתמש, אך קשורים, יכולים להשתמש ב-structuredFormat במקומם. יש שתי דרכים שונות לייצוג חיזוי מקום. אסור למשתמשים לנסות לנתח את structuredFormat ל-text או להיפך.

הטקסט הזה יכול להיות שונה מהטקסט displayName שהוחזר על ידי places.get.

עשוי להיות בשפות משולבות אם הבקשה input וlanguageCode הן בשפות שונות או אם אין למקום תרגום מהשפה המקומית לlanguageCode.

object (StructuredFormat)

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

structuredFormat מומלץ למפתחים שרוצים להציג שני אלמנטים נפרדים של ממשק המשתמש, אך קשורים לכך. אם מפתחים רוצים להציג רכיב אחד של ממשק המשתמש, מומלץ להשתמש במקום זאת ב-text. יש שתי דרכים שונות לייצוג חיזוי מקום. אסור למשתמשים לנסות לנתח את structuredFormat ל-text או להיפך.

string

רשימת הסוגים שחלים על מקום זה מטבלה א' או מטבלה ב' בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.

סוג הוא סיווג של מקום. למקומות עם סוגים משותפים יהיו מאפיינים דומים.

integer

אורך הגיאודזית במטרים מ-origin אם צוין origin. יכול להיות שחיזויים מסוימים, כמו מסלולים, לא יאכלסו את השדה הזה.

{
  "text": string,
  "matches": [
    {
      object (StringRange)
    }
  ]
}

string

טקסט שניתן להשתמש בו כפי שהוא או בפורמט עם matches.

object (StringRange)

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

הערכים האלה הם היסט תווים של Unicode של text. מובטח שהטווחים יסודרו לפי ערכי היסט הולכים וגדלים.

{
  "startOffset": integer,
  "endOffset": integer
}

integer

היסט מבוסס-אפס של תו ה-Unicode הראשון של המחרוזת (כולל).

integer

היסט מבוסס-אפס של תו ה-Unicode האחרון (לא כולל).

{
  "mainText": {
    object (FormattableText)
  },
  "secondaryText": {
    object (FormattableText)
  }
}

object (FormattableText)

מייצג את שם המקום או השאילתה.

object (FormattableText)

מייצג תכונות חד-משמעיות נוספות (כמו עיר או אזור) כדי לזהות עוד יותר את המקום או לצמצם את השאילתה.

{
  "text": {
    object (FormattableText)
  },
  "structuredFormat": {
    object (StructuredFormat)
  }
}

object (FormattableText)

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

text מומלץ למפתחים שרוצים להציג רק רכיב אחד של ממשק המשתמש. מפתחים שרוצים להציג שני אלמנטים נפרדים של ממשק המשתמש, אך קשורים, יכולים להשתמש ב-structuredFormat במקומם. יש שתי דרכים שונות לייצג חיזוי של שאילתה. אסור למשתמשים לנסות לנתח את structuredFormat ל-text או להיפך.

עשוי להיות בשפות משולבות אם הבקשה input ו-languageCode הן בשפות שונות או אם לחלק מהשאילתה אין תרגום מהשפה המקומית לlanguageCode.

object (StructuredFormat)

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

structuredFormat מומלץ למפתחים שרוצים להציג שני אלמנטים נפרדים של ממשק המשתמש, אך קשורים לכך. אם מפתחים רוצים להציג רכיב אחד של ממשק המשתמש, מומלץ להשתמש במקום זאת ב-text. יש שתי דרכים שונות לייצג חיזוי של שאילתה. אסור למשתמשים לנסות לנתח את structuredFormat ל-text או להיפך.