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. כל ביקור באתר יכול לכלול כמה שאילתות, ואחריהן בקשה אחת של פרטי מקום או אימות כתובת. האישורים שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud. אחרי שהסשן מסתיים, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם לא מציינים את הפרמטר session_token או אם משתמשים מחדש בטוקן סשן, הסשן יחויב כאילו לא סופק טוקן סשן (כל בקשה תחויב בנפרד).

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

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

bool

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

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. כל ביקור באתר יכול לכלול כמה שאילתות, ואחריהן בקשה אחת של פרטי מקום או אימות כתובת. האישורים שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud. אחרי שהסשן מסתיים, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם לא מציינים את הפרמטר session_token או אם משתמשים מחדש בטוקן סשן, הסשן יחויב כאילו לא סופק טוקן סשן (כל בקשה תחויב בנפרד).

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

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

סטטוס העסק במקום.
price_level

PriceLevel

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

Attribution

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

string

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

string

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

OpeningHours

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

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

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 ה-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

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

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

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

LocationRestriction

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

שדות

שדה איחוד type.

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

Circle

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

RankPreference

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

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

SearchNearbyResponse

‫Protocol Buffer של התגובה לחיפוש בקרבת מקום.

שדות
places[]

Place

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

RoutingSummary

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

SearchTextRequest

‫Protocol Buffer של בקשת 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 ושדות אחרים שקשורים למיקום של העסקים האלה.

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 של התגובה ל-SearchText.

שדות
places[]

Place

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

RoutingSummary

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

ContextualContent

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

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

string

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

string

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

TravelMode

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

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