סוגי מקומות

בדף הזה מפורטים הערכים הנתמכים של הנכס types.

• טבלה 1 מפרטת את הסוגים שנתמכים בחיפושי מקומות, וניתן להחזיר אותם עם תוצאות של פרטי מקום, וכחלק מחיזויים של מקומות בהשלמה אוטומטית.
• בטבלה 2 מפורטים סוגים נוספים שאפשר להחזיר עם תוצאות של פרטי מקום וכחלק מחיזויים של מקומות בהשלמה אוטומטית.
• טבלה 3 מפרטת את הסוגים שבהם אפשר להשתמש בבקשות להשלמה אוטומטית.

טבלה 1: סוגי מקומות

נעשה שימוש בערכים של סוג מקום בטבלה 1 בדרכים הבאות:

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

טבלה 2: סוגים נוספים שהוחזרו על ידי שירות 'מקומות'

נעשה שימוש בערכים של סוג מקום בטבלה 2 בדרכים הבאות:

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

למידע נוסף על הסוגים האלה, קראו את המאמר סוגי כתובות.

טבלה 3: אוספים של סוגים שנתמכים בבקשות להשלמה אוטומטית של מקומות

כדי להגביל את התוצאות לסוג ספציפי, משתמשים בערכים של סוג המקום בטבלה 3 או בערכים של טבלה 1 וטבלה 2, כחלק מבקשת השלמה אוטומטית של מקום.

אפשר להשתמש רק בסוג אחד מטבלה 3 בבקשה. אם מציינים ערך מטבלה 3, לא ניתן לציין ערך מטבלה 1 או מטבלה 2.

למידע נוסף על הכללים לשימוש בערכים האלה, ראו השלמה אוטומטית למקומות.

הסוגים הנתמכים הם:

• geocode מורה לשירות ההשלמה האוטומטית של מקומות להחזיר תוצאות של קידוד גיאוגרפי בלבד, ולא תוצאות עסקיות. באופן כללי, הבקשה הזו משמשת להבחנה בין תוצאות שבהן המיקום שצוין יכול להיות לא קבוע.
• address מורה לשירות ההשלמה האוטומטית של מקומות להחזיר תוצאות עם קידוד גיאוגרפי רק עם כתובת מדויקת. בדרך כלל, משתמשים בבקשה הזו כשיודעים שהמשתמש מחפש כתובת שצוינה במלואה.
• establishment מורה לשירות ההשלמה האוטומטית של מקומות להחזיר תוצאות עסקיות בלבד.
• האוסף מסוג (regions) מורה לשירות 'מקומות' להחזיר כל תוצאה שתואמת לסוגים הבאים:
  • locality
  • sublocality
  • postal_code
  • country
  • administrative_area_level_1
  • administrative_area_level_2
• האוסף מסוג (cities) מורה לשירות 'מקומות' להחזיר תוצאות שתואמות ל-locality או ל-administrative_area_level_3.