Package google.maps.places.v1

אינדקס

מקומות

הגדרת השירות של Places API. הערה: כל בקשה (מלבד בקשות של השלמה אוטומטית ו-GetPhotoMedia) דורשת הגדרת מסכת שדות מחוץ לפרוטוקול הבקשה (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

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

שדות
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

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

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

bool

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

string

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

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

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

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

bool

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

bool

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

LocationBias

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

שדות

שדה איחוד type.

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

Viewport

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

Circle

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

LocationRestriction

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

שדות

שדה איחוד type.

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

Viewport

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

Circle

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

AutocompletePlacesResponse

‫Protocol Buffer של התשובה ל-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

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

מומלץ להשתמש ב-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 כמרכז ורדיוס.

שדות
center

LatLng

חובה. קו הרוחב וקו האורך של המרכז.

הטווח של קו הרוחב חייב להיות בין ‎-90.0 ל-90.0. הטווח של קו האורך חייב להיות בין ‎-180.0 ל-180.0.
radius

double

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

ContentBlock

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

שדות
content

LocalizedText

תוכן שקשור לנושא.
referenced_places[]

string

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

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. הצדקות של מאפייני זמינות העסק. כאן מוצגים כמה מאפיינים של העסק שעשויים לעניין משתמש קצה.

שדות
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

מידע על טעינת רכב חשמלי שמקובץ לפי [type, max_charge_rate_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. מחבר Type-1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 מערכת טעינה משולבת (AC ו-DC). מבוסס על מחבר Type-2 Mennekes
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 ביניים.
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 של אובייקט Place מגיע בפורמט places/{place_id}/photos/{photo_reference}. כדי לקבל את שם משאב המדיה של התמונה, צריך להוסיף את המחרוזת /media בסוף משאב התמונה.
max_width_px

int32

אופציונלי. מציין את הרוחב המקסימלי הרצוי של התמונה, בפיקסלים. אם התמונה קטנה מהערכים שצוינו, התמונה המקורית תוחזר. אם אחד מהממדים של התמונה גדול יותר, היא תותאם לממד הקטן מבין השניים, בהתאם ליחס הגובה-רוחב המקורי שלה. המאפיינים max_height_px ו-max_width_px מקבלים מספר שלם בין 1 ל-4800, כולל. אם הערך לא נמצא בטווח המותר, תוחזר שגיאת 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 ל-4800, כולל. אם הערך לא נמצא בטווח המותר, תוחזר שגיאת 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

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

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

string

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

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

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

  • מומלץ להשתמש באסימוני סשן לכל הקריאות להשלמה אוטומטית למקומות.
  • צריך ליצור טוקן חדש לכל סשן. מומלץ להשתמש ב-UUID בגרסה 4.
  • חשוב לוודא שפרטי הכניסה שמשמשים לכל הבקשות של השלמה אוטומטית למקומות, Place Details ו-Address Validation בסשן מסוים שייכים לאותו פרויקט ב-מסוף 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

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

string

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

LocalizedText

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

LocalizedText

תווית הסוג של המקום במפות Google, מותאמת לשפה של הבקשה אם רלוונטי. לדוגמה, Restaurant,‏ Cafe,‏ Airport וכו'. יכול להיות שתווית הסוג שונה משם התצוגה של הסוג הראשי, ויכול להיות שהיא לא סוג נתמך בטבלת סוגי המקומות ב-Places API.
national_phone_number

string

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

string

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

string

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

string

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

PostalAddress

הכתובת בפורמט של כתובת למשלוח דואר.
address_components[]

AddressComponent

רכיבים שחוזרים על עצמם לכל רמת מקומיות. הערות לגבי המערך address_components[] ‎: – מערך רכיבי הכתובת עשוי להכיל יותר רכיבים מהכתובת המעוצבת. – המערך לא בהכרח כולל את כל הישויות הפוליטיות שמכילות כתובת, מלבד אלה שנכללות ב-formatted_address. כדי לאחזר את כל הישויות הפוליטיות שמכילות כתובת ספציפית, צריך להשתמש בהמרת קואורדינטות לכתובות (reverse geocoding) ולהעביר את קו הרוחב וקו האורך של הכתובת כפרמטר לבקשה. – אין ערובה לכך שפורמט התשובה יישאר זהה בין בקשות שונות. בפרט, מספר רכיבי הכתובת משתנה בהתאם לכתובת המבוקשת, ויכול להשתנות לאורך זמן עבור אותה כתובת. מיקום הרכיב במערך יכול להשתנות. אפשר לשנות את סוג הרכיב. יכול להיות שרכיב מסוים לא יופיע בתגובה מאוחרת יותר.
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 שמכילה את day עם הערך 0, את hour עם הערך 0 ואת 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

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

Date

התאריך שבו המקום ייפתח בעתיד. השדה הזה מאוכלס רק אם הסטטוס של העסק הוא FUTURE_OPENING.
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

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

GenerativeSummary

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

ContainingPlace

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

AddressDescriptor

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

PriceRange

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

ReviewSummary

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

EvChargeAmenitySummary

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

NeighborhoodSummary

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

ConsumerAlert

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

string

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

string

אם המקום הזה נסגר לתמיד ועבר למקום חדש, השדה הזה מכיל את מזהה המקום של המקום החדש. אם המקום הזה הועבר כמה פעמים, השדה הזה יציג את המקום הראשון שהועבר. השדה הזה לא יאוכלס אם המקום לא עבר לכתובת אחרת.
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

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

AccessibilityOptions

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

שדות
wheelchair_accessible_parking

bool

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

bool

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

bool

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

bool

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

AddressComponent

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

שדות
long_text

string

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

string

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

string

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

string

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

שיוך (Attribution)

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

שדות
provider

string

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

string

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

BusinessStatus

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

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

ConsumerAlert

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

שדות
overview

string

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

Details

פרטי הודעת האזהרה לצרכנים.
language_code

string

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

פרטים

פרטי הודעת האזהרה לצרכנים.

שדות
title

string

הכותרת שתוצג לצד התיאור.
description

string

התיאור של הודעת האזהרה לצרכנים.

ContainingPlace

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

שדות
name

string

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

string

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

EvChargeAmenitySummary

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

שדות
overview

ContentBlock

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

ContentBlock

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

ContentBlock

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

ContentBlock

סיכום של החנויות בסביבה.
flag_content_uri

string

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

LocalizedText

הודעת הגילוי הנאות בנושא AI ‏'Summarized with Gemini' (ותצורות מקומיות שלה). התשובה תהיה בשפה שצוינה בבקשה, אם היא זמינה.

GenerativeSummary

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

שדות
overview

LocalizedText

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

string

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

LocalizedText

הודעת הגילוי הנאות בנושא AI ‏'Summarized with Gemini' (ותצורות מקומיות שלה). התשובה תהיה בשפה שצוינה בבקשה, אם היא זמינה.

NeighborhoodSummary

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

שדות
overview

ContentBlock

סיכום כללי של השכונה.
description

ContentBlock

תיאור מפורט של השכונה.
flag_content_uri

string

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

LocalizedText

הודעת הגילוי הנאות בנושא AI ‏'Summarized with Gemini' (ותצורות מקומיות שלה). התשובה תהיה בשפה שצוינה בבקשה, אם היא זמינה.

OpeningHours

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

שדות
periods[]

Period

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

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

הערה: הסדר של מערך periods לא תלוי בסדר של מערך weekday_descriptions. אל תניחו שהם יתחילו באותו יום.
weekday_descriptions[]

string

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

הערה: סדר הימים ותחילת השבוע נקבעים לפי הלוקאל (השפה והאזור). הסדר של המערך periods לא תלוי בסדר של המערך weekday_descriptions. אל תניחו שהם יתחילו באותו יום.

השדה יהיה ריק אם שעות הפעילות לא ידועות או אם לא ניתן להמיר אותן לטקסט מותאם לשוק המקומי. דוגמה: "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', שמכיל את הסיומת של הקוד הגלובלי ומחליף את הקידומת בשם מפורמט של ישות הפניה.

ReviewSummary

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

שדות
text

LocalizedText

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

string

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

LocalizedText

הודעת הגילוי הנאות בנושא AI ‏'Summarized with Gemini' (ותצורות מקומיות שלה). התשובה תהיה בשפה שצוינה בבקשה, אם היא זמינה.
reviews_uri

string

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

SubDestination

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

שדות
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

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

בדיקה

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

שדות
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.
visit_date

Date

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

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

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

שדות
language_code

string

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

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

string

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

מידע נוסף זמין בכתובת 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

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

bool

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

LocationRestriction

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

שדות

שדה איחוד type.

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

Circle

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

RankPreference

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

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

SearchNearbyResponse

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

שדות
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

קוד המדינה או האזור של Unicode ‏ (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

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

int32

הוצא משימוש: במקומו צריך להשתמש ב-page_size.

המספר המקסימלי של תוצאות שיוחזרו בכל דף. אם מספר התוצאות הזמינות גדול מ-max_result_count, מוחזר next_page_token שאפשר להעביר ל-page_token כדי לקבל את הדף הבא של התוצאות בבקשות הבאות. אם לא מציינים ערך או מציינים את הערך 0, המערכת משתמשת בערך ברירת המחדל 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. ערכים שליליים יחזירו שגיאת 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, צריך לכלול עסקים שרק נותנים שירות באזור מוגדר. עסק שנותן שירות באזור מוגדר הוא עסק שמבקר או שולח מוצרים ללקוחות ישירות, אבל לא מספק שירותים בכתובת העסק. לדוגמה, עסקים שמספקים שירותי ניקיון או שרברבים. לעסקים האלה אין כתובת פיזית או מיקום במפות Google. השירות Places לא יחזיר שדות כולל location,‏ plus_code ושדות אחרים שקשורים למיקום של העסקים האלה.
include_future_opening_businesses

bool

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

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 בשאילתות קטגוריות כמו 'מסעדות בניו יורק', הרלוונטיות היא ברירת המחדל. לשאילתות לא קטגוריות כמו 'מאונטיין ויו, קליפורניה', מומלץ להשאיר את ההגדרה rankPreference ללא ערך.
DISTANCE מדרג את התוצאות לפי מרחק.
RELEVANCE דירוג התוצאות לפי רלוונטיות. סדר המיון נקבע לפי ערימת הדירוג הרגילה.

SearchAlongRouteParameters

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

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

שדות
polyline

Polyline

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

SearchTextResponse

‫Protocol Buffer לתגובה לחיפוש טקסט.

שדות
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. האפשרות הזו נתמכת רק במדינות שמפורטות במאמר מדינות ואזורים שנתמכים בהם כלי רכב דו-גלגליים.