Package google.maps.places.v1

אינדקס

מקומות

הגדרת השירות של Places API. הערה: כל בקשה (למעט בקשות להשלמה אוטומטית) דורשת מסכת שדה שמוגדרת מחוץ ל-proto של הבקשה (all/*, לא מוגדרת כברירת מחדל). אפשר להגדיר את מסכת השדה באמצעות כותרת ה-HTTP X-Goog-FieldMask. מידע נוסף זמין במאמר https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

הפונקציה מחזירה חיזויים עבור הקלט שצוין.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

הצגת הפרטים של מקום על סמך שם המשאב שלו, שהוא מחרוזת בפורמט places/{place_id}.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

חיפוש מקומות ליד מיקומים.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

חיפוש מקומות על סמך שאילתה בטקסט.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

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

שדות
landmarks[]

Landmark

רשימה של ציוני דרך בקרבת מקום, לפי דירוג. ציוני הדרך המוכרים והקרובים ביותר מדורגים ראשונים.
areas[]

Area

רשימה ממוינת של אזורים שמכילים את האזור הרצוי או אזורים סמוכים אליו. האזורים הכי מוכרים ומדויקים מדורגים ראשונים.

אזור

פרטי האזור והקשר של האזור למיקום היעד.

'אזורים' כוללים שכונות, יישובים קטנים ומתחמים גדולים ומדויקים שיכולים לעזור לתאר מיקום.

שדות
name

string

שם המשאב של האזור.
place_id

string

מזהה המקום של האזור.
display_name

LocalizedText

השם המוצג של האזור.
containment

Containment

הגדרת היחס המרחבי בין מיקום היעד לבין האזור.

בלימה

הגדרת היחס המרחבי בין מיקום היעד לבין האזור.

טיפוסים בני מנייה (enum)
CONTAINMENT_UNSPECIFIED לא צוין אמצעי הבידוד.
WITHIN מיקום היעד נמצא בתוך האזור, קרוב למרכז.
OUTSKIRTS מיקום היעד נמצא בתוך אזור הטירגוט, קרוב לקצה.
NEAR מיקום היעד נמצא מחוץ לאזור, אבל קרוב אליו.

ציון דרך

פרטים בסיסיים על ציון הדרך והקשר שלו למיקום היעד.

ציוני דרך הם מקומות בולטים שאפשר להשתמש בהם כדי לתאר מיקום.

שדות
name

string

שם המשאב של ציון הדרך.
place_id

string

מזהה המקום של ציון הדרך.
display_name

LocalizedText

השם המוצג של ציון הדרך.
types[]

string

קבוצה של תגי סוג של ציון הדרך הזה. רשימה מלאה של הערכים האפשריים זמינה בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
spatial_relationship

SpatialRelationship

הגדרת היחס המרחבי בין מיקום היעד לנקודת ציון.
straight_line_distance_meters

float

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

float

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

SpatialRelationship

הגדרת היחס המרחבי בין מיקום היעד לנקודת ציון.

טיפוסים בני מנייה (enum)
NEAR זהו קשר ברירת המחדל כשלא רלוונטית אף אחת מהאפשרויות הספציפיות שמפורטות בהמשך.
WITHIN לאתר המפורסם יש גיאומטריה מרחבית והיעד נמצא בתוך גבולותיו.
BESIDE היעד נמצא צמוד ישירות לנקודת הציון.
ACROSS_THE_ROAD היעד נמצא ממש מול ציון הדרך, בצד השני של הכביש.
DOWN_THE_ROAD באותו מסלול כמו ציון הדרך, אבל לא לידו או מעבר אליו.
AROUND_THE_CORNER לא באותו מסלול כמו ציון הדרך, אבל במרחק פנייה אחת.
BEHIND קרוב למבנה של ציון הדרך, אבל רחוק יותר מהכניסות שלו לרחוב.

AuthorAttribution

מידע על המחבר של נתוני התוכן שנוצר על ידי משתמשים. בשימוש ב-Photo וב-Review.

שדות
display_name

string

השם של האדם שיצר את הPhoto או את הReview.
uri

string

ה-URI של המחבר של ה-Photo או ה-Review.
photo_uri

string

ה-URI של תמונת הפרופיל של המחבר של ה-Photo או ה-Review.

AutocompletePlacesRequest

בקשה ל-proto של AutocompletePlaces.

שדות
input

string

חובה. מחרוזת הטקסט שבה יתבצע החיפוש.
location_bias

LocationBias

זה שינוי אופציונלי. הטיה של התוצאות למיקום ספציפי.

צריך להגדיר רק אחד מבין location_bias או location_restriction. אם לא תגדירו אף אחת מהאפשרויות האלה, התוצאות יהיו מוטה לפי כתובת ה-IP. כלומר, כתובת ה-IP תוצג במיקום לא מדויק ותשמשת כאות מוטה.
location_restriction

LocationRestriction

זה שינוי אופציונלי. להגביל את התוצאות למיקום ספציפי.

צריך להגדיר רק אחד מבין location_bias או location_restriction. אם לא תגדירו אף אחת מהאפשרויות האלה, התוצאות יהיו מוטה לפי כתובת ה-IP. כלומר, כתובת ה-IP תוצג במיקום לא מדויק ותשמשת כאות מוטה.
included_primary_types[]

string

זה שינוי אופציונלי. סוג המקום הראשי שכלול (לדוגמה, 'מסעדה' או 'תחנת דלק') ב'סוגי מקומות' (https://developers.google.com/maps/documentation/places/web-service/place-types), או רק (regions), או רק (cities). מקום מוחזר רק אם הסוג הראשי שלו נכלל ברשימה הזו. אפשר לציין עד 5 ערכים. אם לא מציינים סוגי מקומות, המערכת מחזירה את כל סוגי המקומות.
included_region_codes[]

string

זה שינוי אופציונלי. הצגת תוצאות רק באזורים שצוינו, כפי שצוינו עד 15 קודי אזורים בני שני תווים של CLDR. קבוצה ריקה לא תגביל את התוצאות. אם גם location_restriction וגם included_region_codes מוגדרים, התוצאות ימוקמו באזור החיתוך.
language_code

string

זה שינוי אופציונלי. השפה שבה יוצגו התוצאות. ברירת המחדל היא en-US. התוצאות עשויות להיות בשפות מעורבות אם השפה שבה נעשה שימוש ב-input שונה מ-language_code, או אם למקום שהתקבל אין תרגום מהשפה המקומית ל-language_code.
region_code

string

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

LatLng

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

int32

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

אם השדה ריק, ברירת המחדל היא האורך של input.
include_query_predictions

bool

זה שינוי אופציונלי. אם הערך הוא True, התשובה תכלול גם תחזיות של מקומות וגם תחזיות של שאילתות. אחרת, התשובה תכלול רק תחזיות של מקומות.
session_token

string

זה שינוי אופציונלי. מחרוזת שמזהה סשן של השלמה אוטומטית לצורכי חיוב. חייבת להיות מחרוזת base64 בטוחה לכתובות URL ולשמות של קובצי ASCII באורך של עד 36 תווים. אחרת, תוחזר שגיאת INVALID_ARGUMENT.

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

מומלץ לפעול לפי ההנחיות הבאות:

  • שימוש באסימוני סשן בכל הקריאות של מילוי אוטומטי של מקומות.
  • יוצרים טוקן חדש לכל סשן. מומלץ להשתמש ב-UUID מגרסה 4.
  • חשוב לוודא שפרטי הכניסה שמשמשים לכל הבקשות של השלמה אוטומטית של מקומות, פרטי מקומות ואימות כתובות במהלך סשן שייכים לאותו פרויקט במסוף Cloud.
  • חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. שימוש באותו אסימון ביותר מסשן אחד יוביל לחיוב בנפרד על כל בקשה.
include_pure_service_area_businesses

bool

זה שינוי אופציונלי. אם השדה מוגדר כ-true, צריך לכלול עסקים שנותנים שירות באזור מוגדר בלבד. עסק שנותן שירות באזור מוגדר (SAB) הוא עסק שמספק את השירות בכתובת של הלקוחות או שולח את המוצר ישירות אליהם, אבל לא מספק להם שירות בכתובת של העסק. לדוגמה, עסקים שמספקים שירותי ניקיון או שרברבים. לעסקים האלה אין כתובת פיזית או מיקום במפות Google. המערכת של Places לא תחזיר שדות שכוללים את location, את plus_code ושדות אחרים שקשורים למיקום של העסקים האלה.

LocationBias

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

שדות

שדה האיחוד type.

הערך של type יכול להיות רק אחת מהאפשרויות הבאות:
rectangle

Viewport

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

Circle

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

LocationRestriction

האזור שבו רוצים לחפש. התוצאות יוגבלו לאזור שצוין.

שדות

שדה האיחוד type.

הערך של type יכול להיות רק אחת מהאפשרויות הבאות:
rectangle

Viewport

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

Circle

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

AutocompletePlacesResponse

פרוטו של תגובה עבור AutocompletePlaces.

שדות
suggestions[]

Suggestion

מכילה רשימה של הצעות, שממוינות בסדר יורד של רלוונטיות.

הצעה

תוצאה של הצעה של השלמה אוטומטית.

שדות

שדה האיחוד kind.

הערך של kind יכול להיות רק אחת מהאפשרויות הבאות:
place_prediction

PlacePrediction

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

QueryPrediction

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

FormattableText

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

שדות
text

string

טקסט שאפשר להשתמש בו כפי שהוא או לעצב אותו באמצעות matches.
matches[]

StringRange

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

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

PlacePrediction

תוצאות החיזוי של הצעה להשלמה אוטומטית של מקום.

שדות
place

string

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

string

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

FormattableText

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

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

הטקסט הזה עשוי להיות שונה מה-display_name שהוחזר על ידי GetPlace.

יכול להיות שיהיו בשפות שונות אם הבקשות input ו-language_code הן בשפות שונות, או אם אין למיקום תרגום מהשפה המקומית לשפה language_code.
structured_format

StructuredFormat

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

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

string

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

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

int32

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

QueryPrediction

תוצאות החיזוי של הצעה להשלמה אוטומטית של שאילתות.

שדות
text

FormattableText

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

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

יכול להיות שחלק מהשאילתה יהיה בשפה אחת וחלק בשפה אחרת אם הבקשות input ו-language_code הן בשפות שונות, או אם לחלק מהשאילתה אין תרגום מהשפה המקומית לשפה language_code.
structured_format

StructuredFormat

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

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

StringRange

זיהוי מחרוזת משנה בטקסט נתון.

שדות
start_offset

int32

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

int32

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

StructuredFormat

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

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

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

שדות
main_text

FormattableText

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

FormattableText

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

מעגל

מעגל עם LatLng כמרכז ו-radius.

שדות
center

LatLng

חובה. מרכזים את קו האורך וקו הרוחב.

טווח קו הרוחב חייב להיות בטווח [-90.0, 90.0]. הטווח של קו האורך חייב להיות בטווח [-180.0, 180.0].
radius

double

חובה. רדיוס שנמדד במטרים. הרדיוס חייב להיות בטווח [0.0, 50000.0].

ContentBlock

בלוק של תוכן שאפשר להציג בנפרד.

שדות
topic

string

הנושא של התוכן, לדוגמה 'סקירה כללית' או 'מסעדה'.
content

LocalizedText

תוכן שקשור לנושא.
references

References

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

מקורות מידע שקשורים לבלוק התוכן הזה.

ContextualContent

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

תוכן שמתאים להקשר של שאילתת החיפוש של המקום.

שדות
reviews[]

Review

רשימה של ביקורות על המקום הזה, בהקשר לשאילתה על המקום.
photos[]

Photo

מידע (כולל הפניות) על תמונות של המקום הזה, בהקשר של שאילתה על המקום.
justifications[]

Justification

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

נימוקים להוספת המקום.

הצדקה

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

נימוקים להוספת המקום. בתשובות להצדקות נענה על השאלה למה מקום מסוים יכול לעניין משתמש קצה.

שדות

שדה האיחוד justification.

הערך של justification יכול להיות רק אחת מהאפשרויות הבאות:
review_justification

ReviewJustification

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.
business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

BusinessAvailabilityAttributesJustification

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative. נימוקים של BusinessAvailabilityAttributes. כאן מוצגים כמה מאפיינים של העסק שעשויים לעניין משתמש קצה.

שדות
takeout

bool

אם יש במקום אפשרות לקנות אוכל ארוז.
delivery

bool

אם המקום מספק שירות משלוחים.
dine_in

bool

אם אפשר לאכול במקום.

ReviewJustification

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

שדות
highlighted_text

HighlightedText
review

Review

הביקורת שממנה נוצר הטקסט המודגש.

HighlightedText

הטקסט שמודגש על ידי הפסקה. זוהי קבוצת משנה של הבדיקה עצמה. המילה המדויקת שרוצים להדגיש מסומנת על ידי HighlightedTextRange. יכול להיות שיהיו כמה מילים בטקסט שתוצג להן הדגשה.

שדות
text

string
highlighted_text_ranges[]

HighlightedTextRange

רשימת הטווחים של הטקסט המודגש.

HighlightedTextRange

טווח הטקסט המודגש.

שדות
start_index

int32
end_index

int32

EVChargeOptions

מידע על תחנת הטעינה לרכב חשמלי שמתארחת במקום. המונחים מבוססים על https://afdc.energy.gov/fuels/electricity_infrastructure.html. שקע אחד יכול לטעון רכב אחד בכל פעם. לשקע אחד יש מחבר אחד או יותר. לכל תחנה יש שקע אחד או יותר.

שדות
connector_count

int32

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

ConnectorAggregation

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

ConnectorAggregation

מידע על טעינה של רכב חשמלי (EV) שמקובץ לפי [type, max_charge_rate_kw]. מציג צבירה של טעינה לרכב חשמלי (EV) של מחברים מאותו סוג ושיעור טעינה מקסימלי ב-kW.

שדות
type

EVConnectorType

סוג המחבר של הצבירה הזו.
max_charge_rate_kw

double

קצב הטעינה המקסימלי הסטטי בקילוואט של כל מחבר במצטבר.
count

int32

מספר המחברים בצבירה הזו.
availability_last_update_time

Timestamp

חותמת הזמן של מועד העדכון האחרון של פרטי הזמינות של המחבר במצטבר הזה.
available_count

int32

מספר המחברים בצבירה הזו שזמינים כרגע.
out_of_service_count

int32

מספר המחברים בצבירה הזו שאינם זמינים כרגע.

EVConnectorType

מידע נוסף על סוגי מחברי הטעינה לרכב חשמלי זמין בכתובת http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

טיפוסים בני מנייה (enum)
EV_CONNECTOR_TYPE_UNSPECIFIED מחבר לא צוין.
EV_CONNECTOR_TYPE_OTHER סוגי מחברים אחרים.
EV_CONNECTOR_TYPE_J1772 מחבר J1772 מסוג 1.
EV_CONNECTOR_TYPE_TYPE_2 מחבר מסוג 2 של IEC 62196. לרוב מכונה MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO מחבר מסוג CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 מערכת טעינה משולבת (AC ו-DC). על סמך SAE. מחבר J-1772 מסוג 1
EV_CONNECTOR_TYPE_CCS_COMBO_2 מערכת טעינה משולבת (AC ו-DC). על סמך מחבר Mennekes מסוג 2
EV_CONNECTOR_TYPE_TESLA המחבר הגנרי של TESLA. באמריקה הצפונית, הפורמט הוא NACS, אבל בחלקים אחרים בעולם הוא יכול להיות פורמט שאינו NACS (למשל, CCS Combo 2‏ (CCS2) או GB/T). הערך הזה מייצג פחות את סוג המחבר בפועל, ומייצג יותר את היכולת לטעון רכב מתוצרת Tesla בתחנת טעינה בבעלות Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T הסוג GB/T תואם לתקן GB/T בסין. הסוג הזה מכסה את כל סוגי ה-GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET שקע חשמל לא צוין.
EV_CONNECTOR_TYPE_NACS מערכת הטעינה של צפון אמריקה (NACS), שמוגדרת כתקן SAE J3400.

FuelOptions

המידע העדכני ביותר על סוגי הדלק בתחנת דלק. המידע הזה מתעדכן באופן קבוע.

שדות
fuel_prices[]

FuelPrice

המחיר האחרון הידוע של הדלק בכל סוג דלק בתחנה הזו. יש רשומה אחת לכל סוג דלק בתחנה. הסדר לא חשוב.

FuelPrice

מידע על מחירי דלק מסוג נתון.

שדות
type

FuelType

סוג הדלק.
price

Money

מחיר הדלק.
update_time

Timestamp

השעה שבה מחיר הדלק עודכן לאחרונה.

FuelType

סוגי הדלק.

טיפוסים בני מנייה (enum)
FUEL_TYPE_UNSPECIFIED סוג הדלק לא צוין.
DIESEL סולר.
DIESEL_PLUS סולר ודלק.
REGULAR_UNLEADED דלק רגיל ללא עופרת.
MIDGRADE Midgrade.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG גז פחמימני מעובה.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE מתאן.
BIO_DIESEL ביו-דיזל.
TRUCK_DIESEL סולר למשאיות.

GetPhotoMediaRequest

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

שדות
name

string

חובה. שם המשאב של מדיה של תמונה בפורמט: places/{place_id}/photos/{photo_reference}/media.

שם המשאב של תמונה, כפי שהוא מוחזר בשדה photos.name של אובייקט מקום, מופיע בפורמט places/{place_id}/photos/{photo_reference}. כדי לקבל את שם משאב המדיה של התמונה, צריך לצרף את הערך /media בסוף משאב התמונה.
max_width_px

int32

זה שינוי אופציונלי. מציין את הרוחב המקסימלי הרצוי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, התמונה המקורית תוחזר. אם התמונה גדולה יותר באחת מהמידות, היא תתאים לגודל הקטן מבין שתי המימדים, תוך שמירה על יחס הגובה-רוחב המקורי שלה. גם המאפיין max_height_px וגם המאפיין max_width_px מקבלים מספר שלם בין 1 ל-4,800, כולל. אם הערך לא נמצא בטווח המותר, תוחזר שגיאת INVALID_ARGUMENT.

צריך לציין לפחות אחד מהמאפיינים הבאים: max_height_px או max_width_px. אם לא מציינים את max_height_px או את max_width_px, תוחזר שגיאת INVALID_ARGUMENT.
max_height_px

int32

זה שינוי אופציונלי. הגדרת הגובה המקסימלי הרצוי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, התמונה המקורית תוחזר. אם התמונה גדולה יותר באחת מהמידות, היא תתאים לגודל הקטן מבין שתי המימדים, תוך שמירה על יחס הגובה-רוחב המקורי שלה. גם המאפיין max_height_px וגם המאפיין max_width_px מקבלים מספר שלם בין 1 ל-4,800, כולל. אם הערך לא נמצא בטווח המותר, תוחזר שגיאת INVALID_ARGUMENT.

צריך לציין לפחות אחד מהמאפיינים הבאים: max_height_px או max_width_px. אם לא מציינים את max_height_px או את max_width_px, תוחזר שגיאת INVALID_ARGUMENT.
skip_http_redirect

bool

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

GetPlaceRequest

בקשה לאחזור מקום על סמך שם המשאב שלו, שהוא מחרוזת בפורמט places/{place_id}.

שדות
name

string

חובה. שם המשאב של מקום, בפורמט places/{place_id}.
language_code

string

זה שינוי אופציונלי. פרטי המקום יוצגו בשפה המועדפת, אם היא זמינה.

רשימת השפות הנתמכות הנוכחית: https://developers.google.com/maps/faq#languagesupport.
region_code

string

זה שינוי אופציונלי. קוד המדינה או האזור (CLDR) של Unicode של המיקום שממנו מגיעה הבקשה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם המקום הספציפי לאזור, אם הוא זמין. הפרמטר יכול להשפיע על התוצאות בהתאם לדין החל. מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

לידיעתכם, אין כרגע תמיכה בקודים של אזורים בת 3 ספרות.
session_token

string

זה שינוי אופציונלי. מחרוזת שמזהה סשן של השלמה אוטומטית לצורכי חיוב. חייבת להיות מחרוזת base64 בטוחה לכתובות URL ולשמות של קובצי ASCII באורך של עד 36 תווים. אחרת, תוחזר שגיאת INVALID_ARGUMENT.

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

מומלץ לפעול לפי ההנחיות הבאות:

  • שימוש באסימוני סשן בכל הקריאות של מילוי אוטומטי של מקומות.
  • יוצרים טוקן חדש לכל סשן. מומלץ להשתמש ב-UUID מגרסה 4.
  • חשוב לוודא שפרטי הכניסה שמשמשים לכל הבקשות של השלמה אוטומטית של מקומות, פרטי מקומות ואימות כתובות במהלך סשן שייכים לאותו פרויקט במסוף Cloud.
  • חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. שימוש באותו אסימון ביותר מסשן אחד יוביל לחיוב בנפרד על כל בקשה.

תמונה

מידע על תמונה של מקום.

שדות
name

string

מזהה. הפניה שמייצגת את התמונה של המקום, שאפשר להשתמש בה כדי לחפש אותה שוב (נקראת גם שם 'משאב' ב-API: places/{place_id}/photos/{photo}).
width_px

int32

הרוחב הזמין המקסימלי, בפיקסלים.
height_px

int32

הגובה המקסימלי הזמין, בפיקסלים.
author_attributions[]

AuthorAttribution

המחברים של התמונה הזו.
flag_content_uri

string

קישור שבו משתמשים יכולים לסמן בעיה בתמונה.
google_maps_uri

string

קישור להצגת התמונה במפות Google.

PhotoMedia

מדיה של תמונה מ-Places API.

שדות
name

string

שם המשאב של מדיה של תמונה בפורמט: places/{place_id}/photos/{photo_reference}/media.
photo_uri

string

מזהה URI לטווח קצר שאפשר להשתמש בו כדי להציג את התמונה.

מקום

כל המידע שמייצג מקום.

שדות
name

string

שם המשאב של המקום הזה, בפורמט places/{place_id}. אפשר להשתמש בו כדי לחפש את המקום.
id

string

המזהה הייחודי של מקום.
display_name

LocalizedText

השם המותאם לאזור של המקום, שמתאים לתיאור קצר שקריא לבני אדם. לדוגמה: 'Google Sydney',‏ 'Starbucks',‏ 'Pyrmont' וכו'.
types[]

string

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

string

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

LocalizedText

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

string

מספר טלפון של המקום, בפורמט לאומי שאנשים יכולים לקרוא.
international_phone_number

string

מספר טלפון של המקום בפורמט לחיוג בינלאומי, שאנשים יכולים לקרוא.
formatted_address

string

כתובת מלאה של המקום שקריאה לבני אדם.
short_formatted_address

string

כתובת קצרה שקריאה לבני אדם של המקום הזה.
address_components[]

AddressComponent

רכיבים חוזרים לכל רמת יישוב. שימו לב לעובדות הבאות לגבי המערך address_components[]: - המערך של רכיבי הכתובת עשוי להכיל יותר רכיבים מאשר הערך של formatted_address. - המערך לא כולל בהכרח את כל הישות הפוליטיות שמכילות כתובת, מלבד אלה שכלולות ב-formatted_address. כדי לאחזר את כל הישות הפוליטיות שמכילות כתובת ספציפית, צריך להשתמש בגיאוגקוד הפוך, ולהעביר את קו הרוחב/קו האורך של הכתובת כפרמטר לבקשה. - אין ערובה לכך שהפורמט של התגובה יישאר זהה בין הבקשות. באופן ספציפי, מספר הרכיבים של address_components משתנה בהתאם לכתובת המבוקשת, ויכול להשתנות עם הזמן לאותה כתובת. רכיב יכול לשנות את המיקום במערך. סוג הרכיב יכול להשתנות. יכול להיות שרכיב מסוים יהיה חסר בתגובה מאוחרת יותר.
plus_code

PlusCode

ה-Plus Code של קו הרוחב/אורך של מיקום המקום.
location

LatLng

המיקום של המקום הזה.
viewport

Viewport

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

double

דירוג בין 1.0 ל-5.0, על סמך ביקורות של משתמשים על המקום הזה.
google_maps_uri

string

כתובת URL שמספקת מידע נוסף על המקום הזה.
website_uri

string

האתר המוסמך של המקום הזה, למשל דף הבית של העסק. הערה: במקומות שהם חלק מרשת (למשל, חנות IKEA), בדרך כלל זה יהיה האתר של החנות הספציפית, ולא של הרשת הכוללת.
reviews[]

Review

רשימה של ביקורות על המקום הזה, ממוינות לפי רלוונטיות. אפשר להחזיר עד 5 ביקורות.
regular_opening_hours

OpeningHours

שעות הפעילות הרגילות. הערה: אם המקום תמיד פתוח (24 שעות), השדה close לא יוגדר. לקוחות יכולים להסתמך על כך שזמינות תמידית (24 שעות) מיוצגת כתקופה [open][google.maps.places.v1.Place.OpeningHours.Period.open] שמכילה את [day][Point.day] עם הערך 0, את [hour][Point.hour] עם הערך 0 ואת [minute][Point.minute] עם הערך 0.
time_zone

TimeZone

אזור הזמן של מסד הנתונים של אזורי הזמן של IANA. לדוגמה, 'America/New_York'.
photos[]

Photo

מידע (כולל מקורות) על תמונות של המקום הזה. אפשר להחזיר עד 10 תמונות.
adr_format_address

string

כתובת המקום בפורמט מיקרו adr: http://microformats.org/wiki/adr.
business_status

BusinessStatus

סטטוס העסק של המקום.
price_level

PriceLevel

רמת המחירים במקום.
attributions[]

Attribution

קבוצה של ספקי נתונים שצריך להציג עם התוצאה הזו.
icon_mask_base_uri

string

כתובת URL קטועה של מסכת סמל. המשתמש יכול לגשת לסוגים שונים של סמלים על ידי הוספת סיומת לסוג בסוף (למשל, ‎.svg או ‎.png).
icon_background_color

string

צבע הרקע של icon_mask בפורמט הקסדצימלי, למשל #909CE1.
current_opening_hours

OpeningHours

שעות הפעילות של שבעת הימים הבאים (כולל היום). פרק הזמן מתחיל בחצות בתאריך הבקשה ומסתיים בשעה 23:59 שישה ימים לאחר מכן. השדה הזה כולל את השדה המשני special_days של כל השעות, שמוגדרות לתאריכים עם שעות פעילות חריגות.
current_secondary_opening_hours[]

OpeningHours

מכיל מערך של רשומות לשבעת הימים הבאים, כולל מידע על שעות פעילות משניות של העסק. שעות הפעילות המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את שעות הפעילות של חלון השירות או של המשלוחים כשעות הפעילות המשניות שלה. השדה הזה מאכלס את שדה המשנה type, שמבוסס על רשימה מוגדרת מראש של סוגי שעות פתיחה (כמו DRIVE_THROUGH,‏ PICKUP או TAKEOUT) על סמך סוגי המקום. השדה הזה כולל את השדה המשני special_days של כל השעות, שמוגדרות לתאריכים עם שעות פעילות חריגות.
regular_secondary_opening_hours[]

OpeningHours

מכיל מערך של רשומות עם מידע על שעות פעילות משניות קבועות של עסק. שעות הפעילות המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את שעות הפעילות של חלון השירות או של המשלוחים כשעות הפעילות המשניות שלה. השדה הזה מאכלס את שדה המשנה type, שמבוסס על רשימה מוגדרת מראש של סוגי שעות פתיחה (כמו DRIVE_THROUGH,‏ PICKUP או TAKEOUT) על סמך סוגי המקום.
editorial_summary

LocalizedText

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

PaymentOptions

אפשרויות התשלום שהמקום מקבל. אם נתוני אפשרות התשלום לא זמינים, השדה של אפשרות התשלום לא יוגדר.
parking_options

ParkingOptions

אפשרויות החניה במקום.
sub_destinations[]

SubDestination

רשימה של יעדים משניים שקשורים למיקום.
fuel_options

FuelOptions

המידע העדכני ביותר על סוגי הדלק בתחנת דלק. המידע הזה מתעדכן באופן קבוע.
ev_charge_options

EVChargeOptions

מידע על אפשרויות טעינה לרכב חשמלי (EV).
generative_summary

GenerativeSummary

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום של המקום שנוצר על ידי AI.
area_summary

AreaSummary

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום של האזור שבו נמצא המקום, שנוצר על ידי AI.
containing_places[]

ContainingPlace

רשימה של המקומות שבהם נמצא המקום הנוכחי.
address_descriptor

AddressDescriptor

התיאור של הכתובת של המקום. תיאורי כתובות כוללים מידע נוסף שעוזר לתאר מיקום באמצעות ציוני דרך ואזורים. מידע על הכיסוי האזורי של מאפייני הכתובת זמין בכתובת https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage.
price_range

PriceRange

טווח המחירים שמשויך למקום.
utc_offset_minutes

int32

מספר הדקות שבהן אזור הזמן של המקום הזה שונה כרגע מ-UTC. הערך הזה מוצג בדקות כדי לתמוך באזורי זמן עם עיכוב של חלקי שעה, למשל X שעות ו-15 דקות.
user_rating_count

int32

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

bool

האפשרות הזו קובעת אם העסק תומך בשירותי טייק אווי.
delivery

bool

מציין אם העסק תומך באפשרות של משלוחים.
dine_in

bool

מציין אם יש בעסק מקומות ישיבה בתוך העסק או בחוץ.
curbside_pickup

bool

ההגדרה הזו קובעת אם העסק תומך באיסוף עצמי מחוץ למסעדה.
reservable

bool

מציין אם המקום תומך בהזמנות.
serves_breakfast

bool

מציין אם במקום מוגשת ארוחת בוקר.
serves_lunch

bool

מציין אם במקום מגישים ארוחת צהריים.
serves_dinner

bool

מציין אם במקום מגישים ארוחת ערב.
serves_beer

bool

מציין אם במקום מגישים בירה.
serves_wine

bool

האפשרות הזו קובעת אם במקום מגישים יין.
serves_brunch

bool

האפשרות הזו קובעת אם במקום מוגשות ארוחות בראנץ'.
serves_vegetarian_food

bool

מציין אם במקום מגישים אוכל צמחוני.
outdoor_seating

bool

יש במקום מקומות ישיבה בחוץ.
live_music

bool

במקום מתקיימות הופעות חיות.
menu_for_children

bool

יש במקום תפריט ילדים.
serves_cocktails

bool

במקום מוגשים קוקטיילים.
serves_dessert

bool

במקום הזה מגישים קינוחים.
serves_coffee

bool

במקום הזה מגישים קפה.
good_for_children

bool

המקום מתאים לילדים.
allows_dogs

bool

מותר להכניס כלבים למקום.
restroom

bool

יש במקום שירותים.
good_for_groups

bool

המקום מתאים לקבוצות.
good_for_watching_sports

bool

המקום מתאים לצפייה בספורט.
accessibility_options

AccessibilityOptions

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

bool

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

AccessibilityOptions

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

שדות
wheelchair_accessible_parking

bool

יש חניה נגישה לכיסאות גלגלים.
wheelchair_accessible_entrance

bool

יש כניסה נגישה לכיסאות גלגלים.
wheelchair_accessible_restroom

bool

יש במקום שירותים נגישים לכיסאות גלגלים.
wheelchair_accessible_seating

bool

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

AddressComponent

הרכיבים המובְנים שמרכיבים את הכתובת בפורמט המתאים, אם המידע הזה זמין.

שדות
long_text

string

השם או התיאור המלא בטקסט של רכיב הכתובת. לדוגמה, לרכיב כתובת של המדינה אוסטרליה יכול להיות הערך long_name של 'Australia'.
short_text

string

שם מקוצר של רכיב הכתובת, אם יש כזה. לדוגמה, רכיב כתובת של המדינה אוסטרליה יכול לכלול את השם המקוצר 'AU'.
types[]

string

מערך שמציין את הסוגים של רכיב הכתובת.
language_code

string

השפה שבה נעשה שימוש כדי לעצב את הרכיבים האלה, בסימון CLDR.

AreaSummary

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

שדות
content_blocks[]

ContentBlock

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

string

קישור שבו משתמשים יכולים לסמן בעיה בסיכום.

שיוך (Attribution)

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

שדות
provider

string

השם של ספק הנתונים של המקום.
provider_uri

string

URI לספק הנתונים של המקום.

BusinessStatus

סטטוס העסק של המקום.

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

ContainingPlace

מידע על המקום שבו המקום הזה נמצא.

שדות
name

string

שם המשאב של המקום שבו המקום הזה נמצא.
id

string

מזהה המקום שבו נמצא המקום הזה.

GenerativeSummary

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום של המקום שנוצר על ידי AI.

שדות
overview

LocalizedText

הסקירה הכללית של המקום.
overview_flag_content_uri

string

קישור שבו משתמשים יכולים לסמן בעיה באמצעות סיכום הסקירה הכללית.
description

LocalizedText

התיאור המפורט של המקום.
description_flag_content_uri

string

קישור שבו משתמשים יכולים לסמן בעיה עם סיכום התיאור.
references

References

מקורות המידע ששימשו ליצירת תיאור הסיכום.

OpeningHours

מידע על שעות הפעילות של המקום.

שדות
periods[]

Period

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

string

מחרוזות מותאמות לאזור שמתארות את שעות הפתיחה של המקום, מחרוזת אחת לכל יום בשבוע. השדה יהיה ריק אם השעות לא ידועות או שלא ניתן היה להמיר אותן לטקסט מותאם לשוק המקומי. דוגמה: "Sun: 18:00–06:00"
secondary_hours_type

SecondaryHoursType

מחרוזת טיפוס שמשמש לזיהוי סוג השעות המשניות.
special_days[]

SpecialDay

מידע מובנה לגבי ימים מיוחדים שנכללים בתקופה שבה חלות שעות הפתיחה שהוחזרו. ימים מיוחדים הם ימים שעשויים להשפיע על שעות הפעילות של מקום מסוים, למשל יום חג. מגדירים את השעות האלה בשדות current_opening_hours ו-current_secondary_opening_hours אם יש שעות פעילות חריגות.
next_open_time

Timestamp

הפעם הבאה שבה תקופת שעות הפתיחה הנוכחית תתחיל, עד 7 ימים קדימה. השדה הזה מתמלא רק אם פרק הזמן של שעות הפעילות לא פעיל בזמן שליחת הבקשה.
next_close_time

Timestamp

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

bool

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

נקודה

פרק הזמן שבו המקום נשאר בסטטוס open_now.

שדות
open

Point

השעה שבה המקום מתחיל לפעול.
close

Point

השעה שבה המקום מתחיל להיות סגור.

נקודה

נקודות שינוי סטטוס.

שדות
date

Date

התאריך באזור הזמן המקומי של המקום.
truncated

bool

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

int32

יום בשבוע, כמספר שלם בטווח 0 עד 6. 0 הוא יום ראשון, 1 הוא יום שני וכו'.
hour

int32

השעה בפורמט 24 שעות. הערך יכול להיות בין 0 ל-23.
minute

int32

הדקה. הערך יכול לנוע בין 0 ל-59.

SecondaryHoursType

סוג שמשמש לזיהוי סוג השעות המשניות.

טיפוסים בני מנייה (enum)
SECONDARY_HOURS_TYPE_UNSPECIFIED ערך ברירת המחדל כשסוג השעה המשנית לא צוין.
DRIVE_THROUGH שעת הפעילות של חלון הגבייה בבנקים, במסעדות או בבתי מרקחת.
HAPPY_HOUR שעת השמחה.
DELIVERY שעת האספקה.
TAKEOUT שעת ההזמנה.
KITCHEN שעת הפעילות של המטבח.
BREAKFAST שעת ארוחת הבוקר.
LUNCH שעת הצהריים.
DINNER שעת ארוחת הערב.
BRUNCH שעת הבראנץ'.
PICKUP שעת האיסוף.
ACCESS שעות הגישה למקומות האחסון.
SENIOR_HOURS שעות הפתיחה המיוחדות לאזרחים ותיקים.
ONLINE_SERVICE_HOURS שעות הפעילות באינטרנט.

SpecialDay

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

שדות
date

Date

התאריך של היום המיוחד.

ParkingOptions

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

שדות
free_parking_lot

bool

במקום יש חניונים ללא תשלום.
paid_parking_lot

bool

במקום יש חניונים בתשלום.
free_street_parking

bool

יש חניה בחינם ברחוב.
paid_street_parking

bool

יש חניה ברחוב בתשלום.
valet_parking

bool

במקום יש שירות חניה.
free_garage_parking

bool

במקום יש חניון מקורה בחינם.
paid_garage_parking

bool

במקום יש חניון מקורה בתשלום.

PaymentOptions

אפשרויות התשלום שהמקום מקבל.

שדות
accepts_credit_cards

bool

במקום מקבלים כרטיסי אשראי לתשלום.
accepts_debit_cards

bool

במקום מקבלים תשלומים בכרטיסי חיוב מיידי.
accepts_cash_only

bool

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

bool

במקום הזה מקבלים תשלומים באמצעות NFC.

PlusCode

Plus Code (http://plus.codes) הוא סימון מיקום בשני פורמטים: קוד גלובלי שמגדיר מלבן בגודל 14 על 14 מטר (1/8, 000 של מעלה) או מלבן קטן יותר, וקוד מורכב שבו הקידומת מוחלפת במיקום עזר.

שדות
global_code

string

הקוד הגלובלי (המלא) של המקום, למשל '9FWM33GV+HQ', שמייצג אזור בגודל של 1/8000 מעלות על 1/8000 מעלות (כ-14 על 14 מטרים).
compound_code

string

הקוד המורכב של המקום, למשל '33GV+HQ, Ramberg, Norway', שמכיל את הסיומת של הקוד הגלובלי ומחליף את הקידומת בשם פורמט של ישות עזר.

SubDestination

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

שדות
name

string

שם המשאב של יעד המשנה.
id

string

מזהה המקום של יעד המשנה.

מצולע פתוח

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

שדות
שדה האיחוד polyline_type. מכיל את סוג הקו המרובה. ברירת המחדל של הפלט של Routes API היא encoded_polyline. הערך של polyline_type יכול להיות רק אחת מהאפשרויות הבאות:
encoded_polyline

string

קו פוליגון מקודד, כפי שהוא מוחזר על ידי Routes API כברירת מחדל. המקודד והמפענח.

PriceLevel

רמת המחירים במקום.

טיפוסים בני מנייה (enum)
PRICE_LEVEL_UNSPECIFIED רמת המחיר של המקום לא צוינה או לא ידועה.
PRICE_LEVEL_FREE המקום מספק שירותים בחינם.
PRICE_LEVEL_INEXPENSIVE המקום מספק שירותים במחירים נמוכים.
PRICE_LEVEL_MODERATE המקום מספק שירותים במחירים סבירים.
PRICE_LEVEL_EXPENSIVE המקום מספק שירותים יקרים.
PRICE_LEVEL_VERY_EXPENSIVE המקום מספק שירותים יקרים מאוד.

PriceRange

טווח המחירים שמשויך למקום. אפשר לא להגדיר את end_price, וכך לציין טווח ללא גבול עליון (למשל, 'יותר מ-100$').

שדות
start_price

Money

הקצה התחתון של טווח המחירים (כולל). המחיר צריך להיות שווה לסכום הזה או גבוה ממנו.
end_price

Money

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

קובצי עזר

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

קובץ העזר שאליו התוכן הגנרטיבי קשור.

שדות
reviews[]

Review

ביקורות שמשמשות כמקורות מידע.
places[]

string

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

בדיקה

מידע על ביקורת על מקום.

שדות
name

string

הפניה שמייצגת את הביקורת על המקום, שאפשר להשתמש בה כדי לחפש אותה שוב (נקראת גם שם 'המשאבים' של ה-API: places/{place_id}/reviews/{review}).
relative_publish_time_description

string

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

LocalizedText

הטקסט המותאם לשוק המקומי של הביקורת.
original_text

LocalizedText

טקסט הביקורת בשפה המקורית.
rating

double

מספר בין 1.0 ל-5.0, שנקרא גם מספר הכוכבים.
author_attribution

AuthorAttribution

המחבר של הביקורת הזו.
publish_time

Timestamp

חותמת הזמן של הבדיקה.
flag_content_uri

string

קישור שבו משתמשים יכולים לסמן בעיה בביקורת.
google_maps_uri

string

קישור להצגת הביקורת במפות Google.

RouteModifiers

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

שדות
avoid_tolls

bool

זה שינוי אופציונלי. כשהערך מוגדר כ-true, המערכת תנסה להימנע מכבישי אגרה במקרים שבהם זה אפשרי, ותעדיף מסלולים שלא כוללים כבישי אגרה. המבצע רלוונטי רק ל-DRIVE ול-TWO_WHEELER TravelMode.
avoid_highways

bool

זה שינוי אופציונלי. כשהערך מוגדר כ-true, המערכת תנסה להימנע מכבישים מהירים במקרים שבהם זה אפשרי, ותעדיף מסלולים שלא כוללים כבישים מהירים. המבצע רלוונטי רק ל-DRIVE ול-TWO_WHEELER TravelMode.
avoid_ferries

bool

זה שינוי אופציונלי. כשהערך מוגדר כ-true, המערכת תנסה להימנע ממעבורות במקרים שבהם זה אפשרי, ותעדיף מסלולים שלא כוללים מעבורות. המבצע רלוונטי רק ל-DRIVE ול-TWO_WHEELER TravelMode.
avoid_indoor

bool

זה שינוי אופציונלי. כשהערך מוגדר כ-true, המערכת תנסה להימנע מנווט בתוך מבנים, אם זה אפשרי, ותעדיף מסלולים שלא כוללים ניווט בתוך מבנים. ההגדרה חלה רק על WALK TravelMode.

RoutingParameters

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

שדות
origin

LatLng

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

TravelMode

זה שינוי אופציונלי. אמצעי התחבורה.
route_modifiers

RouteModifiers

זה שינוי אופציונלי. משתני המסלול.
routing_preference

RoutingPreference

זה שינוי אופציונלי. קובעת איך לחשב את סיכומי הניתוחים. השרת מנסה להשתמש בעדיפות הניתוב שנבחרה כדי לחשב את המסלול. האפשרות 'בחירת מסלול לפי תנועה' זמינה רק ב-DRIVE או ב-TWO_WHEELER travelMode.

RoutingPreference

קבוצת ערכים שמציינים גורמים שצריך להביא בחשבון בעת חישוב המסלול.

טיפוסים בני מנייה (enum)
ROUTING_PREFERENCE_UNSPECIFIED לא צוינה העדפת ניתוב. ברירת המחדל היא TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE חישוב המסלולים בלי להביא בחשבון את תנאי התנועה בזמן אמת. מתאים למקרים שבהם מצב התנועה לא רלוונטי או לא חשוב. השימוש בערך הזה מניב את זמן האחזור הנמוך ביותר. הערה: עבור TravelMode, DRIVE ו-TWO_WHEELER, המסלול והמשך הזמן שנבחרים מבוססים על רשת הכבישים ועל תנאי התנועה הממוצעים שאינם תלויים בזמן, ולא על תנאי הכביש הנוכחיים. כתוצאה מכך, המסלולים עשויים לכלול כבישים שסגורים באופן זמני. התוצאות של בקשה מסוימת עשויות להשתנות לאורך זמן בגלל שינויים ברשת הכבישים, תנאי התנועה הממוצעים המעודכנים והאופי המבוזר של השירות. התוצאות עשויות גם להשתנות בין מסלולים כמעט זהים בכל שלב או תדירות.
TRAFFIC_AWARE חישוב מסלולים תוך התחשבות במצב התנועה בזמן אמת. בניגוד ל-TRAFFIC_AWARE_OPTIMAL, חלק מהאופטימיזציות חלות כדי לצמצם משמעותית את זמן האחזור.
TRAFFIC_AWARE_OPTIMAL חישוב המסלולים תוך התחשבות בתנאי התנועה בזמן אמת, בלי להחיל את רוב האופטימיזציות לשיפור הביצועים. השימוש בערך הזה יגרום לזמן האחזור הגבוה ביותר.

RoutingSummary

משך הזמן והמרחק מנקודת המוצא של הניתוב למקום בתגובה, וחלק שני מהמקום הזה ליעד, אם הבקשה הזו נשלחה. הערה: הוספת routingSummaries במסכת השדה בלי לכלול גם את הפרמטר routingParameters.origin או את הפרמטר searchAlongRouteParameters.polyline.encodedPolyline בבקשה גורמת לשגיאה.

שדות
legs[]

Leg

השלבים של הנסיעה.

כשמחשבים את משך הנסיעה ואת המרחק מנקודת מוצא מוגדרת, legs מכיל מקטע אחד שמכיל את משך הנסיעה ואת המרחק מנקודת המוצא ליעד. כשמבצעים חיפוש לאורך מסלול, השדה legs מכיל שתי קטעים: אחד מהמוצא למקום, והשני מהמקום ליעד.
directions_uri

string

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

רגל

שלב הוא קטע יחיד במסע ממיקום אחד למיקום אחר.

שדות
duration

Duration

משך הזמן שנדרש כדי להשלים את הקטע הזה בנסיעה.
distance_meters

int32

המרחק של מקטע הנסיעה הזה.

SearchNearbyRequest

מבקשים proto לחיפוש בקרבת מקום.

שדות
language_code

string

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

רשימת השפות הנתמכות הנוכחית: https://developers.google.com/maps/faq#languagesupport.
region_code

string

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

מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

לידיעתכם, אין כרגע תמיכה בקודים של אזורים בת 3 ספרות.
included_types[]

string

סוג המקום שכלול (למשל, 'מסעדה' או 'תחנת דלק') מ-https://developers.google.com/maps/documentation/places/web-service/place-types.

אפשר לציין עד 50 סוגים מטבלה א'.

אם יש סוגים מתנגשים, כלומר סוג מופיע גם ב-included_types וגם ב-excluded_types, תוחזר השגיאה INVALID_ARGUMENT.

אם מצוין סוג מקום עם כמה הגבלות סוג, רק מקומות שעומדים בכל ההגבלות יחזרו. לדוגמה, אם יש לנו {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, המקומות שמוחזרים מספקים שירותים שקשורים ל'מסעדה', אבל הם לא פועלים בעיקר כ'מסעדות'.
excluded_types[]

string

סוג המקום שסומן כחרג (למשל, 'מסעדה' או 'תחנת דלק') מתוך https://developers.google.com/maps/documentation/places/web-service/place-types.

אפשר לציין עד 50 סוגים מטבלה א'.

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

אם יש סוגים מתנגשים, כלומר סוג מופיע גם ב-included_types וגם ב-excluded_types, תוחזר השגיאה INVALID_ARGUMENT.

אם מצוין סוג מקום עם כמה הגבלות סוג, רק מקומות שעומדים בכל ההגבלות יחזרו. לדוגמה, אם יש לנו {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, המקומות שמוחזרים מספקים שירותים שקשורים ל'מסעדה', אבל הם לא פועלים בעיקר כ'מסעדות'.
included_primary_types[]

string

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

אפשר לציין עד 50 סוגים מטבלה א'.

אם יש סוגים ראשיים סותרים, כלומר סוג מופיע גם ב-included_primary_types וגם ב-excluded_primary_types, תוחזר השגיאה INVALID_ARGUMENT.

אם מצוין סוג מקום עם כמה הגבלות סוג, רק מקומות שעומדים בכל ההגבלות יחזרו. לדוגמה, אם יש לנו {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, המקומות שמוחזרים מספקים שירותים שקשורים ל'מסעדה', אבל הם לא פועלים בעיקר כ'מסעדות'.
excluded_primary_types[]

string

סוג המקום הראשי שהוחרג (למשל 'מסעדה' או 'תחנת דלק') מתוך https://developers.google.com/maps/documentation/places/web-service/place-types.

אפשר לציין עד 50 סוגים מטבלה א'.

אם יש סוגים ראשיים סותרים, כלומר סוג מופיע גם ב-included_primary_types וגם ב-excluded_primary_types, תוחזר השגיאה INVALID_ARGUMENT.

אם מצוין סוג מקום עם כמה הגבלות סוג, רק מקומות שעומדים בכל ההגבלות יחזרו. לדוגמה, אם יש לנו {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]}, המקומות שמוחזרים מספקים שירותים שקשורים ל'מסעדה', אבל הם לא פועלים בעיקר כ'מסעדות'.
max_result_count

int32

המספר המקסימלי של תוצאות להחזרה. הערך חייב להיות בין 1 ל-20 (ברירת המחדל), כולל. אם לא מגדירים את המספר, הוא חוזר לגבול העליון. אם המספר מוגדר כשלילי או חורג מהגבול העליון, תוחזר שגיאת INVALID_ARGUMENT.
location_restriction

LocationRestriction

חובה. האזור שבו רוצים לחפש.
rank_preference

RankPreference

איך התוצאות ירוכזו בתשובה.
routing_parameters

RoutingParameters

זה שינוי אופציונלי. פרמטרים שמשפיעים על הניתוב לתוצאות החיפוש.

LocationRestriction

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

שדות

שדה האיחוד type.

הערך של type יכול להיות רק אחת מהאפשרויות הבאות:
circle

Circle

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

RankPreference

איך התוצאות ירוכזו בתשובה.

טיפוסים בני מנייה (enum)
RANK_PREFERENCE_UNSPECIFIED לא הוגדר ערך של RankPreference. כברירת מחדל, המערכת תשתמש בדירוג לפי פופולריות.
DISTANCE דירוג התוצאות לפי מרחק.
POPULARITY דירוג התוצאות לפי פופולריות.

SearchNearbyResponse

פרוטוקול התגובה לחיפוש בקרבת מקום.

שדות
places[]

Place

רשימה של מקומות שעומדים בדרישות של המשתמש, כמו סוגי מקומות, מספר מקומות והגבלות על מיקומים ספציפיים.
routing_summaries[]

RoutingSummary

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

SearchTextRequest

בקשת proto עבור SearchText.

שדות
text_query

string

חובה. שאילתת הטקסט לחיפוש טקסטואלי.
language_code

string

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

רשימת השפות הנתמכות הנוכחית: https://developers.google.com/maps/faq#languagesupport.
region_code

string

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

מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

לידיעתכם, אין כרגע תמיכה בקודים של אזורים בת 3 ספרות.
rank_preference

RankPreference

איך התוצאות ירוכזו בתשובה.
included_type

string

סוג המקום המבוקש. הרשימה המלאה של הסוגים הנתמכים: https://developers.google.com/maps/documentation/places/web-service/place-types. יש תמיכה רק בסוג אחד של נכס שכלול בקבוצה.
open_now

bool

משמש להגבלת החיפוש למקומות שפתוח כרגע. ברירת המחדל היא false.
min_rating

double

לסנן תוצאות שהדירוג הממוצע שלהן ממשתמשים נמוך מהמגבלה הזו. ערך חוקי חייב להיות מספר עשרוני בין 0 ל-5 (כולל) בקצב של 0.5, כלומר [0, 0.5, 1.0, ... , 5.0] כולל. דירוג הקלט יעוגל כלפי מעלה ל-0.5 הקרוב ביותר(התקרה). לדוגמה, דירוג של 0.6 יבטל את כל התוצאות עם דירוג נמוך מ-1.0.
max_result_count
(deprecated)

int32

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-page_size.

המספר המקסימלי של תוצאות שאפשר להחזיר בכל דף. אם מספר התוצאות הזמינות גדול מ-max_result_count, המערכת מחזירה next_page_token שאפשר להעביר אל page_token כדי לקבל את דף התוצאות הבא בבקשות הבאות. אם מציינים 0 או לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל 20. הערך המקסימלי הוא 20. ערכים מעל 20 יומרו ל-20. אם מזינים ערכים שליליים, הפונקציה מחזירה את השגיאה INVALID_ARGUMENT.

אם מציינים גם את max_result_count וגם את page_size, המערכת תתעלם מ-max_result_count.
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של תוצאות שאפשר להחזיר בכל דף. אם מספר התוצאות הזמינות גדול מ-page_size, המערכת מחזירה next_page_token שאפשר להעביר אל page_token כדי לקבל את דף התוצאות הבא בבקשות הבאות. אם מציינים 0 או לא מציינים ערך, המערכת משתמשת בערך ברירת המחדל 20. הערך המקסימלי הוא 20. ערכים מעל 20 יוגדרו ל-20. אם מזינים ערכים שליליים, הפונקציה מחזירה את השגיאה INVALID_ARGUMENT.

אם מציינים גם את max_result_count וגם את page_size, המערכת תתעלם מ-max_result_count.
page_token

string

זה שינוי אופציונלי. אסימון דף, שהתקבל משיחה קודמת של TextSearch. צריך לספק אותו כדי לאחזר את הדף הבא.

כשמחלקים לדפים, כל הפרמטרים שסופקו ל-TextSearch מלבד page_token,‏ page_size ו-max_result_count חייבים להתאים לקריאה הראשונית שסיפקה את אסימון הדף. אחרת, תוחזר שגיאת INVALID_ARGUMENT.
price_levels[]

PriceLevel

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

bool

משמש להגדרת סינון קפדני של סוגים עבור included_type. אם הערך מוגדר כ-true, יוחזרו רק תוצאות מאותו סוג. ברירת המחדל היא false.
location_bias

LocationBias

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

LocationRestriction

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

EVOptions

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

RoutingParameters

זה שינוי אופציונלי. פרמטרים נוספים לניתוב לתוצאות.
search_along_route_parameters

SearchAlongRouteParameters

זה שינוי אופציונלי. פרוטוקול של פרמטרים נוספים לחיפוש לאורך מסלול.
include_pure_service_area_businesses

bool

זה שינוי אופציונלי. אם השדה מוגדר כ-true, צריך לכלול עסקים שנותנים שירות באזור מוגדר בלבד. עסק שנותן שירות באזור מוגדר (SAB) הוא עסק שמספק את השירות בכתובת של הלקוחות או שולח את המוצר ישירות אליהם, אבל לא מספק להם שירות בכתובת של העסק. לדוגמה, עסקים שמספקים שירותי ניקיון או שרברבים. לעסקים האלה אין כתובת פיזית או מיקום במפות Google. המערכת של Places לא תחזיר שדות שכוללים את location, את plus_code ושדות אחרים שקשורים למיקום של העסקים האלה.

EVOptions

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

שדות
minimum_charging_rate_kw

double

זה שינוי אופציונלי. קצב הטעינה המינימלי הנדרש בקילוואט. מקום עם קצב טעינה נמוך מהקצב שצוין יוסר מהמסנן.
connector_types[]

EVConnectorType

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

LocationBias

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

שדות

שדה האיחוד type.

הערך של type יכול להיות רק אחת מהאפשרויות הבאות:
rectangle

Viewport

תיבת מלבן שמוגדרת לפי הפינה הצפונית-מזרחית והפינה הדרום-מערבית. rectangle.high() חייב להיות הנקודה הצפון-מזרחית של אזור התצוגה המלבני. rectangle.low() חייב להיות הנקודה הדרום-מערבית של אזור התצוגה המלבני. הערך בשדה rectangle.low().latitude() לא יכול להיות גדול מ-rectangle.high().latitude(). התוצאה תהיה טווח ריק של קו הרוחב. שדה הראייה של חלון מרובע לא יכול להיות רחב מ-180 מעלות.
circle

Circle

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

LocationRestriction

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

שדות

שדה האיחוד type.

הערך של type יכול להיות רק אחת מהאפשרויות הבאות:
rectangle

Viewport

תיבת מלבן שמוגדרת לפי הפינה הצפונית-מזרחית והפינה הדרום-מערבית. rectangle.high() חייב להיות הנקודה הצפון-מזרחית של אזור התצוגה המלבני. rectangle.low() חייב להיות הנקודה הדרום-מערבית של אזור התצוגה המלבני. הערך בשדה rectangle.low().latitude() לא יכול להיות גדול מ-rectangle.high().latitude(). התוצאה תהיה טווח ריק של קו הרוחב. שדה הראייה של חלון מרובע לא יכול להיות רחב מ-180 מעלות.

RankPreference

איך התוצאות ירוכזו בתשובה.

טיפוסים בני מנייה (enum)
RANK_PREFERENCE_UNSPECIFIED בשאילתה קטגורית כמו 'מסעדות בעיר ניו יורק', 'רלוונטיות' היא ברירת המחדל. בשאילתות לא קטגוריות, כמו 'Mountain View, CA', מומלץ להשאיר את rankPreference ללא הגדרה.
DISTANCE דירוג התוצאות לפי מרחק.
RELEVANCE דירוג התוצאות לפי רלוונטיות. סדר המיון נקבע לפי סטאק הדירוג הרגיל.

SearchAlongRouteParameters

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

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

שדות
polyline

Polyline

חובה. הקו הפוליגוני של המסלול.

SearchTextResponse

פרוטו לתגובה של SearchText.

שדות
places[]

Place

רשימה של מקומות שעומדים בקריטריונים של חיפוש הטקסט של המשתמש.
routing_summaries[]

RoutingSummary

רשימה של סיכומי ניתוב שבה כל רשומה משויכת למקום המתאים באותו אינדקס בשדה places. אם סיכום המסלול לא זמין לאחד מהמקומות, הוא יכיל רשומה ריקה. אם תבקשו, הרשימה הזו תכלול את כל הרשומות של רשימת המקומות.
contextual_contents[]

ContextualContent

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

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

string

אסימון שאפשר לשלוח כ-page_token כדי לאחזר את הדף הבא. אם השדה הזה מושמט או ריק, אין דפים נוספים.
search_uri

string

הקישור מאפשר למשתמש לחפש במפות Google באמצעות אותה שאילתת טקסט שצוינה בבקשה.

TravelMode

אפשרויות של מצב נסיעה. האפשרויות האלה תואמות למה שRoutes API מציע.

טיפוסים בני מנייה (enum)
TRAVEL_MODE_UNSPECIFIED לא צוין מצב נסיעה. ברירת המחדל היא DRIVE.
DRIVE נסיעה במכונית פרטית.
BICYCLE נסיעה באופניים. לא נתמך ב-search_along_route_parameters.
WALK נסיעה בהליכה. לא נתמך ב-search_along_route_parameters.
TWO_WHEELER כלי רכב דו-גלגליים ממונעים מכל הסוגים, כמו קורקינטים ואופנועים. חשוב לזכור שהאפשרות הזו שונה מאמצעי ההגעה BICYCLE, שכולל תחבורה מונעת על ידי אדם. לא נתמך ב-search_along_route_parameters. התכונה נתמכת רק במדינות שמפורטות בקטע מדינות ואזורים נתמכים לכלי רכב דו-גלגליים.