Package google.maps.locationselection.v1beta

אינדקס

LocationSelectionBeta

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

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

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

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

חיפוש נקודות איסוף במיקום נתון.
FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

מחפשים את נקודות האיסוף של מקום נתון.

כתובת

כתובת של מקום.

שדות
formatted_address

FormattedAddress

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

AddressComponent

רשימה של רכיבי הכתובת.

AddressComponent

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

שדות
component_text

string

שם הרכיב הזה שמתאר חלק מהכתובת. לדוגמה: 'California',‏ 'Amphitheatre Parkway'.
component_text_short_form

string

הכינוי של טקסט הרכיב. לדוגמה, הקוד של קליפורניה הוא 'CA' והקוד של ארה"ב הוא 'US'.
types[]

string

סוגי הרכיב הזה שמתארים חלק מהכתובת. רשימה של הסוגים הנתמכים זמינה בכתובת https://developers.google.com/places/web-service/supported_types#table2

מתחם

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

שדות
type

CompoundType

סוג התרכובת.
geometry

Geometry

הגיאומטריה שמשויכת למתחם.
entrances[]

Entrance

רשימת הכניסות שמשויכות למתחם.

CompoundTypeEnums

סוגי התרכובים

CompoundType

הערך של סוג ההרכב.

טיפוסים בני מנייה (enum)
COMPOUND_TYPE_UNSPECIFIED סוג התרכובת לא ידוע.
SECTION קטע של מתחם. https://support.google.com/mapskb/answer/7054299
BUILDING מבנה מורכב. https://support.google.com/mapskb/answer/7013011
GROUNDS שטח מתחם. https://support.google.com/mapskb/answer/7046859

כניסה

הכניסה למקום.

שדות
location

LatLng

מיקום הכניסה.

FindNearbyPlacesRequest

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

שדות
localization_preferences

LocalizationPreferences

חובה. ההעדפות שמשמשות ללוקליזציה של הטקסטים בתשובה, למשל שם וכתובת.
search_location

LatLng

חובה. המיקום שבו צריך למצוא את המקומות.
max_results

int32

חובה. המספר המקסימלי של תוצאות שיוחזר. חייב להיות גדול מ-0.
wifi_access_points[]

WiFiAccessPoint

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

FindNearbyPlacesResponse

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

שדות
place_results[]

PlaceResult

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

FindPickupPointsForLocationRequest

הודעת בקשה של FindpickupPointsForLocation.

שדות
localization_preferences

LocalizationPreferences

חובה. ההעדפות שמשמשות ללוקליזציה של הטקסטים בתשובה, למשל שם וכתובת.
search_location

LatLng

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

PickupPointOrder

חובה. סדר להצגת התוצאות.
destination

LatLng

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

int32

חובה. המספר המקסימלי של תוצאות שיוחזר. הערך חייב להיות גדול מ-0.
travel_modes[]

TravelMode

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

bool

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

bool

אם הערך הוא true והוגדר יעד, מחושב זמן הנסיעה המשוער מנקודת האיסוף ליעד.
wifi_access_points[]

WiFiAccessPoint

נקודות גישה (AP) של Wi-Fi מסביב למיקום החיפוש. משמש לספק תוצאות חיפוש באיכות גבוהה יותר.

FindPickupPointsForLocationResponse

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

שדות
place_pickup_point_results[]

PlacePickupPointResult

נקודות איסוף בקרבת מקום עם מזהה מקום משויך. התוצאות ברשימה הזו ממוינות לפי הקריטריונים שצוינו בבקשה. מספר התוצאות ב-'place_pickup_point_results' עשוי להיות גבוה ממספר התוצאות ב-'place_results'.
place_results[]

PlaceResult

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

FindPickupPointsForPlaceRequest

הודעת בקשה של FindpickupPointsForPlace.

שדות
place_id

string

חובה. מזהה המקום של המקום שעבורו מבקשים נקודות איסוף.
localization_preferences

LocalizationPreferences

חובה. ההעדפות שמשמשות ללוקליזציה של הטקסטים בתשובה, למשל שם וכתובת.
search_location

LatLng

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

PickupPointOrder

חובה. סדר להצגת התוצאות.
destination

LatLng

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

int32

חובה. המספר המקסימלי של תוצאות להחזרה. הערך חייב להיות גדול מ-0.
travel_modes[]

TravelMode

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

bool

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

bool

אם הערך הוא true והוגדר יעד, מחושב זמן הנסיעה המשוער מנקודת האיסוף ליעד.

FindPickupPointsForPlaceResponse

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

שדות
pickup_point_results[]

PickupPointResult

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

PlaceResult

המקום שמשויך למזהה המקום שצוין בבקשה.

FormattedAddress

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

שדות
lines[]

string

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

גיאומטריה

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

שדות
location

LatLng

הנקודה המרכזית של הישות שמכילה את ההודעה הזו.
viewport

Viewport

חלון תצוגה שמתאים להצגת המקום במפה בגודל ממוצע.
display_boundary

Struct

מציין פוליגון באמצעות פורמט הפוליגון של GeoJSON

LocalizationPreferences

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

שדות
language_code

string

חובה. תג השפה מסוג BCP-47 שמשמש ללוקליזציה של הטקסטים. דוגמאות לתג שפה: 'en-US',‏ 'hi-IN',‏ 'fr-CA' וכו'.
region_code

string

חובה. קוד המדינה או האזור (CLDR) של Unicode במיקום שממנו מגיעה הבקשה, למשל 'US' ו-'419'.

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#unicode_region_subtag.

PickupPoint

פרטים על נקודת איסוף או הורדה.

שדות
id

string

מזהה ייחודי של נקודת האיסוף. הנוכחות חייבת להופיע.
display_name

string

שם קצר שקריא לבני אדם של נקודת האיסוף. מותאם לשוק המקומי בהתאם להעדפה שצוינה בבקשה.
address

Address

הכתובת של נקודת האיסוף.
description

string

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

LatLng

המיקום של נקודת האיסוף – המקום שבו נוסע או מקבל יפגוש עם הנהג. השדה הזה חייב להופיע.

PickupPointOrderEnums

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

PickupPointOrder

הערך של סדר ההזמנות של נקודת האיסוף.

טיפוסים בני מנייה (enum)
PICKUP_POINT_ORDER_UNSPECIFIED לא צוין סדר של נקודות האיסוף. ברירת המחדל היא DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION סדר עולה לפי המרחק של הקו הישר ממיקום החיפוש אל נקודת האיסוף שהוחזרה.
WALKING_ETA_FROM_SEARCH_LOCATION בסדר עולה לפי זמן ההליכה של הצרכן ממיקום החיפוש לנקודת האיסוף.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION סדר עולה לפי זמן ההגעה המשוער (ETA) ברכב מנקודת האיסוף ליעד של הצרכן. אפשר להשתמש במצב הזה רק כשיעד הנסיעה מוגדר ו-compute_driving_eta הוא true. כשיש כמה שיטות נסיעה בבקשה, הסדר מבוסס על שיטת הנסיעה הראשונה בבקשה.

PickupPointResult

פרטים על תוצאת חיפוש של נקודת איסוף.

שדות
pickup_point

PickupPoint

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

float

המרחק בקו ישר מנקודת האיסוף הזו אל search_location שצוין בבקשה.
travel_details[]

TravelDetail

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

מקום

פרטים על מקום מסוים.

שדות
place_id

string

מזהה המקום של המקום. מזהה מקום הוא טקסט שמזהה מקום באופן ייחודי. https://developers.google.com/places/web-service/place-id
display_name

string

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

string

קוד השפה של שדות הטקסט שמשויכים למקום. לדוגמה, 'name' ו-'address'.
address

Address

הכתובת של המקום.
geometry

Geometry

הגיאומטריה של המקום.
types[]

string

קבוצה של תגי סוג לתוצאה הזו. לדוגמה, 'פוליטי' ו'יישוב'. https://developers.google.com/places/web-service/supported_types
associated_compounds[]

Compound

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

PlacePickupPointResult

נקודות איסוף עם מזהה המקום המשויך.

שדות
pickup_point_result

PickupPointResult

פרטים על נקודת האיסוף. השדה הזה חייב להופיע.
associated_place_id

string

מזהה המקום המשויך.

PlaceResult

פרטים על תוצאת חיפוש של מקום.

שדות
place

Place

פרטים על מקום מסוים.
distance_meters

float

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

TrafficRestrictionEnums

סוגי הגבלות התנועה במיקום מסוים.

TrafficRestriction

הערך של הגבלת התנועה.

טיפוסים בני מנייה (enum)
TRAFFIC_RESTRICTION_UNSPECIFIED ההגבלה לא לא צוינה.
NO_RESTRICTION לא חלות הגבלות על התנועה.
OTHER_RESTRICTION יכול להיות שיחולו הגבלות תנועה מסוימות, למשל הכביש פרטי או שיש תשלום על הגישה למיקום המשויך.

TravelDetail

הפרטים שמשויכים לנסיעה.

שדות
travel_mode

TravelMode

מצב הנסיעה שבו מחושב זמן ההגעה המשוער.
estimated_arrival_time

Timestamp

זמן ההגעה המשוער. זמן ההגעה המשוער ברגל מחושב ממיקום החיפוש למיקום של נקודת האיסוף כשהאפשרות compute_walking_eta מוגדרת בבקשה. זמן ההגעה המשוער ברכב מחושב ממיקום נקודת האיסוף ליעד לכל אמצעי תחבורה שביקשתם שאינו הליכה, כשהפרמטרים compute_driving_eta ו-destination מוגדרים בבקשה. זמן הנסיעה המשוער מחושב לפי תנועה, והוא לא כפוף להגבלות בגלל עומסי תנועה.
traffic_restriction

TrafficRestriction

ההגבלה שחלה על אופן הנסיעה.

TravelModeEnums

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

TravelMode

הערך של אמצעי התחבורה.

טיפוסים בני מנייה (enum)
TRAVEL_MODE_UNSPECIFIED לא צוין מצב הנסיעה.
WALKING הליכה, משמש להולכי רגל.
DRIVING נהיגה, משמש למכוניות נוסעים.
TWO_WHEELER כלי רכב דו-גלגלי ממונע (למשל אופנוע או טוסטוס).

WiFiAccessPoint

פרטי נקודת הגישה ל-Wi-Fi.

שדות
mac_address

int64

כתובת ה-MAC של נקודת הגישה.
strength_dbm

sint32

עוצמת האות של נקודת הגישה, ב-dBm.