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

Package google.maps.places.v1

אינדקס

Places (ממשק)
AuthorAttribution (הודעה)
AutocompletePlacesRequest (הודעה)
AutocompletePlacesRequest.LocationBias (הודעה)
AutocompletePlacesRequest.LocationRestriction (הודעה)
AutocompletePlacesResponse (הודעה)
AutocompletePlacesResponse.Suggestion (הודעה)
AutocompletePlacesResponse.Suggestion.FormattableText (הודעה)
AutocompletePlacesResponse.Suggestion.PlacePrediction (הודעה)
AutocompletePlacesResponse.Suggestion.QueryPrediction (הודעה)
AutocompletePlacesResponse.Suggestion.StringRange (הודעה)
AutocompletePlacesResponse.Suggestion.StructuredFormat (הודעה)
Circle (הודעה)
ContentBlock (הודעה)
ContextualContent (הודעה)
ContextualContent.Justification (הודעה)
ContextualContent.Justification.BusinessAvailabilityAttributesJustification (הודעה)
ContextualContent.Justification.ReviewJustification (הודעה)
ContextualContent.Justification.ReviewJustification.HighlightedText (הודעה)
ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange (הודעה)
EVChargeOptions (הודעה)
EVChargeOptions.ConnectorAggregation (הודעה)
EVConnectorType (טיפוס טיפוסים בני מנייה (enum))
FuelOptions (הודעה)
FuelOptions.FuelPrice (הודעה)
FuelOptions.FuelPrice.FuelType (טיפוס טיפוסים בני מנייה (enum))
GetPhotoMediaRequest (הודעה)
GetPlaceRequest (הודעה)
Photo (הודעה)
PhotoMedia (הודעה)
Place (הודעה)
Place.AccessibilityOptions (הודעה)
Place.AddressComponent (הודעה)
Place.AreaSummary (הודעה)
Place.Attribution (הודעה)
Place.BusinessStatus (טיפוס טיפוסים בני מנייה (enum))
Place.GenerativeSummary (הודעה)
Place.OpeningHours (הודעה)
Place.OpeningHours.Period (הודעה)
Place.OpeningHours.Period.Point (הודעה)
Place.OpeningHours.SecondaryHoursType (טיפוס טיפוסים בני מנייה (enum))
Place.OpeningHours.SpecialDay (הודעה)
Place.ParkingOptions (הודעה)
Place.PaymentOptions (הודעה)
Place.PlusCode (הודעה)
Place.SubDestination (הודעה)
PriceLevel (טיפוס טיפוסים בני מנייה (enum))
References (הודעה)
Review (הודעה)
SearchNearbyRequest (הודעה)
SearchNearbyRequest.LocationRestriction (הודעה)
SearchNearbyRequest.RankPreference (טיפוס טיפוסים בני מנייה (enum))
SearchNearbyResponse (הודעה)
SearchTextRequest (הודעה)
SearchTextRequest.EVOptions (הודעה)
SearchTextRequest.LocationBias (הודעה)
SearchTextRequest.LocationRestriction (הודעה)
SearchTextRequest.RankPreference (טיפוס טיפוסים בני מנייה (enum))
SearchTextResponse (הודעה)

מקומות

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

AutocompletePlaces

AutocompletePlaces
`rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)` מחזירה חיזויים עבור הקלט הנתון.

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

GetPhotoMedia

GetPhotoMedia
`rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)` קבלת מדיה של תמונה עם מחרוזת של הפניה לתמונה.

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

GetPlace

GetPlace
`rpc GetPlace(GetPlaceRequest) returns (Place)` אפשר לקבל את הפרטים של מקום לפי שם המשאב שלו, שהוא מחרוזת בפורמט `places/{place_id}`.

rpc GetPlace(GetPlaceRequest) returns (Place)

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

SearchNearby

SearchNearby
`rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)` מחפשים מקומות ליד מיקומים.

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

SearchText

SearchText
`rpc SearchText(SearchTextRequest) returns (SearchTextResponse)` חיפוש מקום שמבוסס על שאילתת טקסט.

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

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

AuthorAttribution

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

שדות

שדות
`display_name`	`string` שם המחבר של המסמך `Photo` או `Review`.
`uri`	`string` ה-URI של המחבר של `Photo` או `Review`.
`photo_uri`	`string` ה-URI של תמונת הפרופיל של המחבר של `Photo` או `Review`.

display_name

string

שם המחבר של המסמך Photo או Review.

uri

string

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

photo_uri

string

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

AutocompletePlacesRequest

בקשת Proto ל-GenerativePlaces.

שדות
`input`	`string` חובה. מחרוזת הטקסט שבה יש לחפש.
`location_bias`	`LocationBias` זה שינוי אופציונלי. הטיית התוצאות למיקום ספציפי. צריך להגדיר עד `location_bias` או `location_restriction`. אם לא תגדירו אף אחת מהאפשרויות, התוצאות ימופו לפי כתובת IP. כלומר, כתובת ה-IP ימופה למיקום לא מדויק ותשמש כאות הטיה.
`location_restriction`	`LocationRestriction` זה שינוי אופציונלי. הגבלת התוצאות למיקום מסוים. צריך להגדיר עד `location_bias` או `location_restriction`. אם לא תגדירו אף אחת מהאפשרויות, התוצאות ימופו לפי כתובת IP. כלומר, כתובת ה-IP ימופה למיקום לא מדויק ותשמש כאות הטיה.
`included_primary_types[]`	`string` זה שינוי אופציונלי. סוג מקום ראשי (למשל, "מסעדה" או "gas_station") מטבלה א' או מטבלה ב' בסוגי מקומות (https://developers.google.com/maps/documentation/places/web-service/place-types), או רק (אזורים), או רק (ערים). מקום מוחזר רק אם הסוג הראשי שלו כלול ברשימה הזו. אפשר לציין עד 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, התשובה תכלול גם חיזויים של Place וגם של השאילתה. אחרת, התשובה תחזיר רק חיזויים של מקומות.
`session_token`	`string` זה שינוי אופציונלי. מחרוזת המזהה פעילות של השלמה אוטומטית למטרות חיוב. חייב להיות מחרוזת base64 בטוחה לכתובת URL ולשם קובץ עם 36 תווי ASCII לכל היותר. אחרת, מוחזרת שגיאת INVALID_ARGUMENT. הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהוא בוחר מקום ומתבצעת קריאה לפרטי מקום או לאימות כתובת. כל סשן יכול לכלול מספר שאילתות, ואחריו בקשה אחת לאימות פרטי מקום או בקשה לאימות כתובת. פרטי הכניסה שבהם נעשה שימוש לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud. לאחר סיום הסשן, האסימון כבר לא תקף. האפליקציה שלכם צריכה ליצור אסימון חדש לכל סשן. אם לא מזינים את הפרמטר `session_token`, או אם משתמשים שוב באסימון סשן, הסשן יחויב כאילו לא סופק אסימון סשן (כל בקשה מחויבת בנפרד). מומלץ לפעול לפי ההנחיות הבאות: שימוש באסימוני הפעלה בכל הקריאות להשלמה אוטומטית של מקומות. ליצור אסימון חדש לכל סשן. מומלץ להשתמש ב-UUID בגרסה 4. מוודאים שפרטי הכניסה שבהם נעשה שימוש בכל הבקשות להשלמה אוטומטית של מקומות, לפרטי מקום ולאימות כתובת בסשן שייכים לאותו פרויקט במסוף Cloud. חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. שימוש באותו אסימון למשך יותר מסשן אחד יגרום לכך שכל בקשה תחויב בנפרד.

LocationBias

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

שדות

שדות
שדה איחוד `type`. `type` יכול להיות רק אחת מהאפשרויות הבאות:
`rectangle`	`Viewport` אזור תצוגה שמוגדר לפינה צפון מזרחית ופינה דרום-מערבית.
`circle`	`Circle` מעגל שמוגדר לפי נקודת מרכז ורדיוס.

שדה איחוד type.

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

rectangle

Viewport

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

circle

Circle

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

LocationRestriction

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

שדות

שדות
שדה איחוד `type`. `type` יכול להיות רק אחת מהאפשרויות הבאות:
`rectangle`	`Viewport` אזור תצוגה שמוגדר לפינה צפון מזרחית ופינה דרום-מערבית.
`circle`	`Circle` מעגל שמוגדר לפי נקודת מרכז ורדיוס.

שדה איחוד type.

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

rectangle

Viewport

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

circle

Circle

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

AutocompletePlacesResponse

קובץ תגובה של תגובה ל'מקומות של השלמה אוטומטית'.

שדות

שדות
`suggestions[]`	`Suggestion` מכילה רשימת הצעות, בסדר יורד לפי רלוונטיות.

suggestions[]

Suggestion

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

הצעה

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

שדות

שדות
שדה איחוד `kind`. `kind` יכול להיות רק אחת מהאפשרויות הבאות:
`place_prediction`	`PlacePrediction` חיזוי לגבי מקום.
`query_prediction`	`QueryPrediction` חיזוי לשאילתה.

שדה איחוד kind.

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

place_prediction

PlacePrediction

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

query_prediction

QueryPrediction

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

FormattableText

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

שדות

שדות
`text`	`string` טקסט שניתן להשתמש בו כפי שהוא או בפורמט עם `matches`.
`matches[]`	`StringRange` רשימה של טווחי מחרוזות המשמשים לזיהוי המיקום שבו נמצאה התאמה לבקשת הקלט ב-`text`. אפשר להשתמש בטווחים כדי לעצב חלקים ספציפיים של `text`. יכול להיות שמחרוזות המשנה לא יהיו התאמות מדויקות של `input` אם ההתאמה נקבעה לפי קריטריונים אחרים מלבד התאמה למחרוזות (לדוגמה, תיקוני איות או תעתיקים). הערכים האלה הם היסט תווים של Unicode של `text`. מובטח שהטווחים יסודרו לפי ערכי היסט הולכים וגדלים.

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` חלוקה של החיזוי לגבי מקום לטקסט ראשי שמכיל את שם המקום ולטקסט משני, עם מאפיינים נוספים (כמו עיר או אזור). `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` או להיפך.

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 האחרון (לא כולל).

start_offset

int32

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

end_offset

int32

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

StructuredFormat

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

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

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

שדות

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

main_text

FormattableText

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

secondary_text

FormattableText

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

מעגל

מעגל עם LatLng בתור מרכז ורדיוס.

שדות

שדות
`center`	`LatLng` חובה. קו הרוחב וקו האורך במרכז. טווח קו הרוחב חייב להיות בטווח של [-90.0, 90.0]. טווח קו האורך חייב להיות בטווח של [ -180.0, 180.0].
`radius`	`double` חובה. רדיוס שנמדד במטרים. הרדיוס חייב להיות בטווח של [0.0, 50000.0].

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. קובצי עזר שקשורים לקטע התוכן הזה.

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. נימוקים לציין את המקום.

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.

שדה איחוד 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` אם יש במקום אכילה במקום.

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` הביקורת שממנה נוצר הטקסט המודגש.

highlighted_text

HighlightedText

review

Review

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

HighlightedText

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

שדות

שדות
`text`	`string`
`highlighted_text_ranges[]`	`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` רשימה של צבירת מחברים של תחנות טעינה לרכבים חשמליים (EV) שמכילים מחברים מאותו סוג וקצב טעינה זהה.

connector_count

int32

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

connector_aggregation[]

ConnectorAggregation

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

ConnectorAggregation

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

שדות
`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`	מחבר IEC 62196 מסוג 2. מכונה בדרך כלל MENNEKES.
`EV_CONNECTOR_TYPE_CHADEMO`	מחבר מסוג CHAdeMO.
`EV_CONNECTOR_TYPE_CCS_COMBO_1`	מערכת טעינה משולבת (AC ו-DC). מבוסס על SAE. מחבר Type-1 J-1772
`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`	שקע חשמל לא צוין.

FuelOptions

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

שדות

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

fuel_prices[]

FuelPrice

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

FuelPrice

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

שדות

שדות
`type`	`FuelType` סוג הדלק.
`price`	`Money` מחיר הדלק.
`update_time`	`Timestamp` המועד שבו מחיר הדלק עודכן לאחרונה.

type

FuelType

סוג הדלק.

price

Money

מחיר הדלק.

update_time

Timestamp

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

FuelType

סוגי הדלק.

טיפוסים בני מנייה (enum)
`FUEL_TYPE_UNSPECIFIED`	סוג הדלק לא צוין.
`DIESEL`	סולר.
`REGULAR_UNLEADED`	רגילה ללא עופרת.
`MIDGRADE`	ביניים.
`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.
`METHANE`	מתאן.
`BIO_DIESEL`	ביו-דיזל.
`TRUCK_DIESEL`	סולר למשאית.

GetPhotoMediaRequest

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

שדות
`name`	`string` חובה. שם המשאב של מדיה של תמונה בפורמט: `places/{place_id}/photos/{photo_reference}/media`. שם המשאב של תמונה שמוחזר בשדה `photos.name` באובייקט Place צריך להיות בפורמט `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). אם המדיניות לא מוגדרת, תונפק הפניה אוטומטית מסוג 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) של המיקום שממנו הבקשה מגיעה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם מקום ספציפי לאזור, אם קיים. הפרמטר יכול להשפיע על התוצאות בהתאם לחוק הרלוונטי. מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. שימו לב: כרגע אין תמיכה בקודי אזור בני 3 ספרות.
`session_token`	`string` זה שינוי אופציונלי. מחרוזת המזהה פעילות של השלמה אוטומטית למטרות חיוב. חייב להיות מחרוזת base64 בטוחה לכתובת URL ולשם קובץ עם 36 תווי ASCII לכל היותר. אחרת, מוחזרת שגיאת 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` המחברים של התמונה הזו.

PhotoMedia

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

שדות

שדות
`name`	`string` שם המשאב של מדיה של תמונה בפורמט: `places/{place_id}/photos/{photo_reference}/media`.
`photo_uri`	`string` URI לטווח קצר שיכול לשמש לעיבוד התמונה.

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` האתר המוסמך של המקום הזה, למשל דף הבית של עסק. הערה: במקומות שהם חלק מרשת (למשל חנות איקאה), האתר יהיה בדרך כלל האתר של החנות הספציפית, ולא של הרשת הכוללת.
`reviews[]`	`Review` רשימת הביקורות על המקום הזה, ממוינת לפי רלוונטיות. אפשר להחזיר עד 5 ביקורות.
`regular_opening_hours`	`OpeningHours` שעות הפעילות הרגילות.
`photos[]`	`Photo` מידע (כולל הפניות) על תמונות של המקום הזה. אפשר להחזיר עד 10 תמונות.
`adr_format_address`	`string` כתובת המקום במיקרו פורמט של מודעה: 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` מכיל מערך של רשומות עבור שבעת הימים הבאים, כולל מידע על שעות משניות של עסק. שעות הפתיחה המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה: מסעדה יכולה לציין את שעות הפתיחה של החנות או את שעות המשלוח כשעות הפעילות המשניות שלה. השדה הזה מאכלס את שדה המשנה של הסוג, שנובע מרשימה מוגדרת מראש של סוגי שעות פתיחה (כמו drive_THROUGH, PICKUP או TAKEOUT) לפי סוגי המקומות. השדה הזה כולל את שדה המשנה Special_days (ימים מיוחדים) של כל השעות, שמוגדר לתאריכים עם שעות יוצאות דופן.
`regular_secondary_opening_hours[]`	`OpeningHours` מכיל מערך של ערכים למידע על שעות המשנה הרגילות של עסק. שעות הפתיחה המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה: מסעדה יכולה לציין את שעות הפתיחה של החנות או את שעות המשלוח כשעות הפעילות המשניות שלה. השדה הזה מאכלס את שדה המשנה של הסוג, שנובע מרשימה מוגדרת מראש של סוגי שעות פתיחה (כמו 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 לגבי האזור שבו המקום נמצא.
`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` מידע על אפשרויות הנגישות במקום.

AccessibilityOptions

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

שדות
`wheelchair_accessible_parking`	`bool` במקום יש חניה נגישה לכיסאות גלגלים.
`wheelchair_accessible_entrance`	`bool` יש מקומות בכניסה נגישה לכיסאות גלגלים.
`wheelchair_accessible_restroom`	`bool` במקום יש שירותים נגישים לכיסאות גלגלים.
`wheelchair_accessible_seating`	`bool` במקום יש מקומות ישיבה נגישים לכיסאות גלגלים.

AddressComponent

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

שדות
`long_text`	`string` הטקסט או התיאור המלא של רכיב הכתובת. לדוגמה, רכיב כתובת עבור המדינה אוסטרליה עשוי לקבל long_name בשם 'אוסטרליה'.
`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` קטעי תוכן שמרכיבים את סיכום האזור. לכל בלוק יש נושא נפרד לגבי האזור.

content_blocks[]

ContentBlock

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

שיוך (Attribution)

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

שדות

שדות
`provider`	`string` שם ספק הנתונים של המקום.
`provider_uri`	`string` URI לספק הנתונים של המקום.

provider

string

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

provider_uri

string

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

BusinessStatus

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

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

GenerativeSummary

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

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

שדות

שדות
`overview`	`LocalizedText` סקירה כללית על המקום.
`description`	`LocalizedText` התיאור המפורט של המקום.
`references`	`References` קובצי עזר שמשמשים ליצירת תיאור הסיכום.

overview

LocalizedText

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

description

LocalizedText

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

references

References

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

OpeningHours

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

שדות
`periods[]`	`Period` התקופות שבהן המקום הזה פתוח במהלך השבוע. התקופות מסודרות בסדר כרונולוגי, החל מיום ראשון לפי אזור הזמן המקומי. ערך ריק (אבל לא חסר) מציין מקום שאף פעם לא פתוח. למשל, כי הוא סגור זמנית לצורך שיפוצים.
`weekday_descriptions[]`	`string` מחרוזות מותאמות לשוק המקומי שמתארות את שעות הפתיחה של המקום, מחרוזת אחת לכל יום בשבוע. השדה יהיה ריק אם שעות הפעילות לא ידועות או אם לא ניתן להמיר אותן לטקסט מותאם לשוק המקומי. דוגמה: "ראשון: 18:00–06:00"
`secondary_hours_type`	`SecondaryHoursType` מחרוזת סוג שמשמשת לזיהוי הסוג של שעות המשנה.
`special_days[]`	`SpecialDay` מידע מובנה לימים מיוחדים שחלים בתקופה של שעות הפתיחה שהוחזרו. ימים מיוחדים הם ימים שעשויים להשפיע על שעות הפעילות של מקום מסוים, כמו יום חג המולד. מגדירים את הערכים current_opening_hours ו-current_secondary_opening_hours אם יש שעות יוצאות דופן.
`open_now`	`bool` האם המקום הזה פתוח עכשיו? מוצג תמיד, אלא אם אין לנו נתונים של השעה ביום או אזור הזמן לגבי שעות הפתיחה האלה.

נקודה

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

שדות

שדות
`open`	`Point` השעה שבה המקום מתחיל להיפתח.
`close`	`Point` השעה שבה המקום מתחיל להיסגר.

open

Point

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

close

Point

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

נקודה

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

שדות
`date`	`Date` התאריך באזור הזמן המקומי של המקום.
`truncated`	`bool` מציין אם נקודת הקצה נחתכה או לא. הקיצוץ מתרחש כשהשעות האמיתיות נמצאות מחוץ לשעות שבהן אנחנו מוכנים להחזיר שעות, לכן אנחנו מקצרים את השעות בחזרה לגבולות האלה. כך אפשר להבטיח שיוחזרו לכל היותר 24 * 7 שעות מחצות של יום הבקשה.
`day`	`int32` יום בשבוע, כמספר שלם בטווח 0-6. 0 הוא יום ראשון, 1 הוא יום שני וכו'.
`hour`	`int32` השעה בשתי ספרות. נע בין 00 ל-23.
`minute`	`int32` הדקה בשתי ספרות. נע בין 00 ל-59.

SecondaryHoursType

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

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

SpecialDay

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

שדות

שדות
`date`	`Date` התאריך של היום המיוחד הזה.

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) הוא הפניה למיקום בשני פורמטים: קוד גלובלי שמגדיר 14mx14m (1/8, 000 במעלה) או מלבן קטן יותר, וקוד מורכב שמחליף את הקידומת במיקום של הפניה.

שדות

שדות
`global_code`	`string` הקוד הגלובלי (מלא) של המקום, כמו '9FWM33GV+HQ', שמייצג שטח של 1/8,000 על 1/8,000 מעלות (כ-14 על 14 מטרים).
`compound_code`	`string` קוד מורכב של מקום, למשל '33GV+HQ, Rammber, נורבגיה', שמכיל את הסיומת של הקוד הגלובלי ומחליף את הקידומת בשם בפורמט של ישות עזר.

global_code

string

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

compound_code

string

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

SubDestination

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

שדות

שדות
`name`	`string` שם המשאב של יעד המשנה.
`id`	`string` מזהה המקום של יעד המשנה.

name

string

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

id

string

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

PriceLevel

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

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

קובצי עזר

ניסיוני: פרטים נוספים זמינים בכתובת 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` חותמת הזמן של הביקורת.

SearchNearbyRequest

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

שדות
`language_code`	`string` פרטי המקום יוצגו בשפה המועדפת, אם יש כזו. אם קוד השפה לא צוין או לא מזוהה, ייתכן שיוחזרו פרטי מקום משפה כלשהי, עם עדיפות לאנגלית אם פרטים כאלה קיימים. הרשימה הנוכחית של השפות הנתמכות: https://developers.google.com/maps/faq#languagesupport.
`region_code`	`string` קוד המדינה או האזור (CLDR) של המיקום שממנו הבקשה מגיעה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם מקום ספציפי לאזור, אם קיים. הפרמטר יכול להשפיע על התוצאות בהתאם לחוק הרלוונטי. מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. שימו לב: כרגע אין תמיכה בקודי אזור בני 3 ספרות.
`included_types[]`	`string` סוג מקום כלול (למשל, "מסעדה" או "gas_station") מהכתובת https://developers.google.com/maps/documentation/places/web-service/place-types. אפשר לציין עד 50 סוגים מתוך טבלה א'. אם יש סוגים מתנגשים, כלומר איזה סוג מופיע גם ב-include_types וגם ב-excluded_types, תוחזר שגיאת INVALID_ARGUMENT. אם מציינים סוג מקום עם כמה הגבלות על סוגים, מוחזרים רק מקומות שעומדים בכל ההגבלות. לדוגמה, אם יש לנו: {included_types = ["restaurant"], exclude_primary_types = ["restaurant"]}, המקומות שהוחזרו מספקים שירותים שקשורים ל'מסעדה' אבל לא פועלים בעיקר בתור 'מסעדות'.
`excluded_types[]`	`string` סוג מקום שלא נכלל (למשל, "מסעדה" או "gas_station") מהכתובת https://developers.google.com/maps/documentation/places/web-service/place-types. אפשר לציין עד 50 סוגים מתוך טבלה א'. אם הלקוח מספק גם את המאפיינים included_types (לדוגמה, מסעדה) וגם את non_types (למשל, cafe), התשובה צריכה לכלול מקומות שהם מסעדה אבל לא בית קפה. התגובה כוללת מקומות שתואמים לפחות לאחד מסוג included_types וגם אף אחד מה-excluded_types. אם יש סוגים מתנגשים, כלומר איזה סוג מופיע גם ב-include_types וגם ב-excluded_types, תוחזר שגיאת INVALID_ARGUMENT. אם מציינים סוג מקום עם כמה הגבלות על סוגים, מוחזרים רק מקומות שעומדים בכל ההגבלות. לדוגמה, אם יש לנו: {included_types = ["restaurant"], exclude_primary_types = ["restaurant"]}, המקומות שהוחזרו מספקים שירותים שקשורים ל'מסעדה' אבל לא פועלים בעיקר בתור 'מסעדות'.
`included_primary_types[]`	`string` סוג מקום ראשי (למשל, "מסעדה" או "gas_station") מהכתובת https://developers.google.com/maps/documentation/places/web-service/place-types. אפשר לשייך למקום רק סוג ראשי אחד מטבלת הסוגים הנתמכים. אפשר לציין עד 50 סוגים מתוך טבלה א'. אם יש סוגים ראשיים סותרים, כלומר סוג מופיע גם ב- included_primary_types וגם ב-excluded_primary_types, תוחזר שגיאת INVALID_ARGUMENT. אם מציינים סוג מקום עם כמה הגבלות על סוגים, מוחזרים רק מקומות שעומדים בכל ההגבלות. לדוגמה, אם יש לנו: {included_types = ["restaurant"], exclude_primary_types = ["restaurant"]}, המקומות שהוחזרו מספקים שירותים שקשורים ל'מסעדה' אבל לא פועלים בעיקר בתור 'מסעדות'.
`excluded_primary_types[]`	`string` סוג מקום ראשי שלא נכלל (למשל "מסעדה" או "gas_station") מהכתובת https://developers.google.com/maps/documentation/places/web-service/place-types. אפשר לציין עד 50 סוגים מתוך טבלה א'. אם יש סוגים ראשיים סותרים, כלומר סוג מופיע גם ב- included_primary_types וגם ב-excluded_primary_types, תוחזר שגיאת INVALID_ARGUMENT. אם מציינים סוג מקום עם כמה הגבלות על סוגים, מוחזרים רק מקומות שעומדים בכל ההגבלות. לדוגמה, אם יש לנו: {included_types = ["restaurant"], exclude_primary_types = ["restaurant"]}, המקומות שהוחזרו מספקים שירותים שקשורים ל'מסעדה' אבל לא פועלים בעיקר בתור 'מסעדות'.
`max_result_count`	`int32` מספר התוצאות המקסימלי שיש להחזיר. הערך חייב להיות בין 1 ל-20 (ברירת מחדל), כולל. אם המספר לא מוגדר, הוא יחזור למגבלה העליונה. אם המספר מוגדר כשלילי או חורג מהגבול העליון, מוחזרת השגיאה INVALID_ARGUMENT.
`location_restriction`	`LocationRestriction` חובה. האזור לחיפוש.
`rank_preference`	`RankPreference` איך התוצאות מדורגות בתגובה.

LocationRestriction

האזור לחיפוש.

שדות

שדה איחוד type.

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

circle

Circle

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

RankPreference

איך התוצאות מדורגות בתגובה.

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

SearchNearbyResponse

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

שדות

places[]

Place

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

SearchTextRequest

בקשת Proto של SearchText.

שדות
`text_query`	`string` חובה. שאילתת הטקסט לחיפוש טקסטואלי.
`language_code`	`string` פרטי המקום יוצגו בשפה המועדפת, אם יש כזו. אם קוד השפה לא צוין או לא מזוהה, ייתכן שיוחזרו פרטי מקום משפה כלשהי, עם עדיפות לאנגלית אם פרטים כאלה קיימים. הרשימה הנוכחית של השפות הנתמכות: https://developers.google.com/maps/faq#languagesupport.
`region_code`	`string` קוד המדינה או האזור (CLDR) של המיקום שממנו הבקשה מגיעה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם מקום ספציפי לאזור, אם קיים. הפרמטר יכול להשפיע על התוצאות בהתאם לחוק הרלוונטי. מידע נוסף זמין בכתובת 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` יש לסנן תוצאות שדירוג המשתמשים הממוצע שלהן נמוך מאוד מהמגבלה הזו. ערך חוקי חייב להיות מספר ממשי (float) בין 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 קודמת. צריך לספק אותה כדי לאחזר את הדף הבא. במהלך החלוקה לדפים, כל הפרמטרים מלבד `page_token`, `page_size` ו-`max_result_count` שסופקו ל-TextSearch חייבים להתאים לקריאה הראשונית שסיפקה את אסימון הדף. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.
`price_levels[]`	`PriceLevel` משמשת להגבלת החיפוש למקומות שמסומנים כרמות מחירים מסוימות. המשתמשים יכולים לבחור כל שילובים של רמות מחירים. ברירת המחדל היא בחירה בכל רמות המחירים.
`strict_type_filtering`	`bool` משמשת להגדרת סינון סוגים מחמיר עבור included_type. אם היא מוגדרת כ-True, יוחזרו רק תוצאות מאותו סוג. ברירת המחדל היא False.
`location_bias`	`LocationBias` האזור לחיפוש. המיקום הזה משמש כהטיה, כך שייתכן שיתקבלו תוצאות לגבי מיקום נתון. לא ניתן להגדיר יחד עם location_restriction.
`location_restriction`	`LocationRestriction` האזור לחיפוש. המיקום הזה משמש כהגבלה, ולכן לא יוחזרו תוצאות מחוץ למיקום הנתון. לא ניתן להגדיר יחד עם הפרמטר location_bia.
`ev_options`	`EVOptions` זה שינוי אופציונלי. מגדירים את אפשרויות הרכב החשמלי הניתנות לחיפוש של בקשה לחיפוש מקום.

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

RankPreference

איך התוצאות מדורגות בתגובה.

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

SearchTextResponse

אב-טיפוס של תגובה ל-SearchText.

שדות

places[]

Place

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

contextual_contents[]

ContextualContent

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

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

next_page_token

string

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