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' עבור 'קליפורניה' ו'ארה"ב' עבור 'ארצות הברית'.
types[]

string

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

מתחם

מתחם שמשויך למקום.

שדות
type

CompoundType

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

Geometry

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

Entrance

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

CompoundTypeEnums

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

CompoundType

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

טיפוסים בני מנייה (enums)
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

הודעת הבקשה FindCollectionPointsForLocation.

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

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

FindPickupPointsForLocationResponse

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

שדות
place_pickup_point_results[]

PlacePickupPointResult

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

PlaceResult

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

FindPickupPointsForPlaceRequest

הודעת בקשה של Find PickupPointsForPlace.

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

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

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

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

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

קוד השפה של שדות הטקסט המשויכים למקום. לדוגמה, 'שם' ו'כתובת'.
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

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

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

TravelDetail

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

שדות
travel_mode

TravelMode

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

Timestamp

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

TrafficRestriction

ההגבלה שחלה על אמצעי ההגעה.

TravelModeEnums

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

TravelMode

הערך של אמצעי ההגעה.

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

WiFiAccessPoint

מידע על נקודת הגישה (AP) של Wi-Fi.

שדות
mac_address

int64

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

sint32

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