Package google.maps.geocode.v4alpha

אינדקס

• ‫DestinationService (ממשק)
• ‫GeocodeService (ממשק)
• ‫Destination (הודעה)
• ‫Destination.ArrivalSummary (הודעה)
• ‫Entrance (הודעה)
• Entrance.Tag (enum)
• ‫GeocodeAddressRequest (הודעה)
• ‫GeocodeAddressRequest.LocationBias (הודעה)
• ‫GeocodeAddressResponse (הודעה)
• ‫GeocodeLocationRequest (הודעה)
• ‫GeocodeLocationResponse (הודעה)
• ‫GeocodePlaceRequest (הודעה)
• ‫GeocodeResult (הודעה)
• ‫GeocodeResult.AddressComponent (הודעה)
• GeocodeResult.Granularity (enum)
• ‫Landmark (הודעה)
• Landmark.Tag (enum)
• ‫NavigationPoint (הודעה)
• NavigationPoint.TravelMode (enum)
• NavigationPoint.Usage (enum)
• ‫PlaceView (הודעה)
• PlaceView.StructureType (enum)
• ‫PlusCode (הודעה)
• ‫SearchDestinationsRequest (הודעה)
• ‫SearchDestinationsRequest.AddressQuery (הודעה)
• ‫SearchDestinationsRequest.LocationQuery (הודעה)
• ‫SearchDestinationsRequest.LocationQuery.PlaceFilter (הודעה)
• SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability (enum)
• ‫SearchDestinationsResponse (הודעה)

DestinationService

שירות לאחזור יעדים.

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

SearchDestinations
rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse) השיטה הזו מבצעת חיפוש של יעדים ומחזירה רשימה של יעדים. היקפי הרשאות נדרש אחד מהיקפי ההרשאות הבאים של OAuth: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode

GeocodeService

שירות לביצוע המרה של כתובות לקואורדינטות (geocoding).

GeocodeAddress
rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse) השיטה הזו ממירה כתובת לקואורדינטות, כלומר ממפה כתובת ל-LatLng. היא גם מספקת מידע מובנה על הכתובת. היקפי הרשאות נדרש אחד מהיקפי ההרשאות הבאים של OAuth: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.address

GeocodeLocation
rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse) השיטה הזו ממירה מיקום לקואורדינטות, כלומר ממפה LatLng לכתובת. היא גם מספקת מידע מובנה על הכתובת. היקפי הרשאות נדרש אחד מהיקפי ההרשאות הבאים של OAuth: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.location

GeocodePlace
rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult) השיטה הזו מבצעת חיפוש של קואורדינטות באמצעות מזהה מקום. היקפי הרשאות נדרש אחד מהיקפי ההרשאות הבאים של OAuth: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.place

יעד

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

שדות
primary	PlaceView המקום הראשי שזוהה על ידי primary_query בבקשה.
containing_places[]	PlaceView מקומות פחות מדויקים שהמקום הראשי נכלל בהם. לדוגמה, מתחם הדירות שבו נמצא הבניין הזה.
sub_destinations[]	PlaceView יעדי משנה מדויקים יותר של המקום הראשי. לדוגמה, יחידות שממוקמות בבניין. הערה: בהשוואה לSubDestination שמוחזר על ידי Places API, הרשימה הזו של יעדי משנה מקיפה יותר, וכל יעד משנה מכיל יותר מידע.
landmarks[]	Landmark ציוני דרך שאפשר להשתמש בהם כדי להסביר איפה היעד נמצא או כדי לעזור להגיע אליו.
entrances[]	Entrance כניסות ליעד הזה.
navigation_points[]	NavigationPoint נקודות ניווט ליעד הזה.
arrival_summary	Destination.ArrivalSummary סיכום שנוצר על ידי AI של חוויית ההגעה ליעד.

ArrivalSummary

סיכום שנוצר על ידי AI של חוויית ההגעה ליעד.

שדות
text	LocalizedText סיכום של חוויית ההגעה ליעד.
flag_content_url	string קישור שדרכו משתמשים יכולים לסמן בעיה בסיכום.
disclosure_text	LocalizedText פלט בלבד. מכיל את טקסט הגילוי הנאות של סיכום ההגעה.

כניסה

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

שדות
location	LatLng המיקום של הכניסה.
tags[]	Entrance.Tag רשימת תגים שמתארים את הכניסה.
place	string המבנה שבו הכניסה ממוקמת פיזית, בפורמט places/{place_id}.

תג

מאפיינים שמתארים כניסה.

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

GeocodeAddressRequest

הודעת בקשה ל-GeocodeService.GeocodeAddress.

שדות
location_bias	GeocodeAddressRequest.LocationBias אופציונלי. האזור לחיפוש. המיקום הזה משמש כהטיה, כלומר יכול להיות שיוחזרו תוצאות שמסביב למיקום הנתון.
language_code	string אופציונלי. השפה שצריך להחזיר בה את התוצאות.
region_code	string אופציונלי. קוד אזור. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. הפרמטר משפיע על התוצאות בהתאם לדין החל. הפרמטר הזה ישפיע גם על התוצאות מהשירות, אבל לא יגביל אותן באופן מלא.
שדה איחוד address_input. הכתובת שצריך להמיר לקואורדינטות. הערך address_input יכול להיות רק אחד מהבאים:
address_query	string הכתובת הלא מובנית שצריך להמיר לקואורדינטות.
address	PostalAddress הכתובת המובנית שצריך להמיר לקואורדינטות בפורמט של כתובת למשלוח דואר.

LocationBias

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

שדות
שדה איחוד type. סוגים של הטיה לפי מיקום. הערך type יכול להיות רק אחד מהבאים:
rectangle	Viewport תיבת מלבן שמוגדרת על ידי הפינה הצפון-מזרחית והפינה הדרום-מערבית. הערך rectangle.high() צריך להיות הנקודה הצפון-מזרחית של אזור התצוגה המלבני. הערך rectangle.low() צריך להיות הנקודה הדרום-מערבית של אזור התצוגה המלבני. הערך בשדה rectangle.low().latitude() לא יכול להיות גדול מ-rectangle.high().latitude(). התוצאה תהיה טווח ריק של קווי רוחב. הרוחב של אזור התצוגה המלבני לא יכול להיות גדול מ-180 מעלות.

GeocodeAddressResponse

הודעת תגובה לGeocodeService.GeocodeAddress.

שדות
results[]	GeocodeResult תוצאת הגיאו-קידוד.

GeocodeLocationRequest

הודעת בקשה ל-GeocodeService.GeocodeLocation.

שדות
language_code	string אופציונלי. השפה שצריך להחזיר בה את התוצאות.
region_code	string אופציונלי. קוד אזור. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. הפרמטר משפיע על התוצאות בהתאם לדין החל.
types[]	string אופציונלי. קבוצה של תגי סוג להגבלת התוצאות. תוצאות שלא כוללות אף אחד מהסוגים שצוינו יוסרו. רשימה מלאה של הערכים האפשריים מופיעה בטבלה A ובטבלה B בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]	GeocodeResult.Granularity אופציונלי. מסנן של ספירות (enum) של רמת פירוט של מיקום אחד או יותר.
שדה איחוד location_input. המיקום שצריך להמיר לקואורדינטות. הערך location_input יכול להיות רק אחד מהבאים:
location_query	string המיקום בפורמט של מחרוזת 'lat,lng'. לדוגמה, "64.7611872,-18.4705364".
location	LatLng המיקום בפורמט המובנה.

GeocodeLocationResponse

הודעת תגובה לGeocodeService.GeocodeLocation.

שדות
results[]	GeocodeResult תוצאת הגיאו-קידוד.
plus_code	PlusCode ה-Plus Code של המיקום שצוין בבקשה.

GeocodePlaceRequest

הודעת בקשה ל-GeocodeService.GeocodePlace.

שדות
place	string חובה. מזהה המקום שצריך להמיר לקואורדינטות בפורמט places/{place}.
language_code	string אופציונלי. השפה שצריך להחזיר בה את התוצאות.
region_code	string אופציונלי. קוד אזור. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. הפרמטר משפיע על התוצאות בהתאם לדין החל.

GeocodeResult

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

שדות
place	string מזהה המקום שמוגדר במלואו של התוצאה הזו. בפורמט ‎//places.googleapis.com/places/{placeID}‎. פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/place-id.
place_id	string מזהה המקום של התוצאה הזו.
location	LatLng הקואורדינטות של הכתובת.
granularity	GeocodeResult.Granularity רמת הפירוט של המיקום.
viewport	Viewport אזור תצוגה שמתאים להצגת תוצאת הגיאו-קידוד.
bounds	Viewport תיבה תוחמת לכתובת.
formatted_address	string הכתובת בפורמט של שורה אחת.
postal_address	PostalAddress הכתובת בפורמט של כתובת למשלוח דואר.
address_components[]	GeocodeResult.AddressComponent רכיבים שחוזרים על עצמם לכל רמת מקומיות.
postal_code_localities[]	LocalizedText רשימה מלאה של היישובים שכלולים במיקוד. השדה הזה מאוכלס רק אם התוצאה היא מסוג postal_code.
types[]	string קבוצה של תגי סוג לתוצאה הזו. לדוגמה, 'פוליטי' ו'אזור אדמיניסטרטיבי'. רשימה מלאה של הערכים האפשריים מופיעה בטבלה A ובטבלה B בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
plus_code	PlusCode ‫Plus Code של המיקום בגיאו-קוד הזה.

AddressComponent

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

שדות
long_text	string התיאור המלא של רכיב הכתובת או השם שלו. לדוגמה, רכיב כתובת של המדינה אוסטרליה יכול להיות עם שם ארוך 'אוסטרליה'.
short_text	string שם טקסטואלי מקוצר של רכיב הכתובת, אם יש כזה. לדוגמה, לרכיב כתובת של אוסטרליה יכול להיות שם מקוצר 'AU'.
types[]	string מערך שמציין את הסוגים של רכיב הכתובת. פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
language_code	string השפה שמשמשת לעיצוב הרכיבים האלה, בסימון CLDR.

רמת פירוט

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

טיפוסים בני מנייה (enum)
GRANULARITY_UNSPECIFIED	אין להשתמש בו.
ROOFTOP	המיקום הלא משוער של חלקה בפועל שתואם לכתובת שהוזנה.
RANGE_INTERPOLATED	הערך הוא אינטרפולציה מטווח של מספרי רחוב. לדוגמה, אם אנחנו יודעים שקטע של Amphitheatre Pkwy מכיל את המספרים 1600 עד 1699, אז יכול להיות שהמספר 1650 ימוקם באמצע בין נקודות הקצה שלו.
GEOMETRIC_CENTER	המרכז הגיאומטרי של ישות שיש לנו לגביה נתונים פוליגונליים.
APPROXIMATE	כל השאר.

ציון דרך

ציוני דרך משמשים כדי לציין איפה היעד נמצא או כדי לעזור להגיע ליעד.

שדות
relational_description	LocalizedText תיאור קריא לאנשים של הקשר בין היעד לבין נקודת הציון. לדוגמה: 'ליד בניין אמפייר סטייט' או 'מול הבית הלבן'.
tags[]	Landmark.Tag תגים שמתארים איך אפשר להשתמש בציון הדרך בהקשר של היעד.
straight_line_distance_meters	double פלט בלבד. המרחק בקו ישר מנקודת הציון הזו ליעד במטרים.
travel_distance_meters	double פלט בלבד. המרחק בין ציון הדרך הזה ליעד במטרים, בחישוב לפי רשת הכבישים.
שדה איחוד landmark. ציון הדרך. הערך landmark יכול להיות רק אחד מהבאים:
place	PlaceView המקום שמייצג את ציון הדרך הזה.

תג

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

אם לכתובת יש גם את התג ADDRESS וגם את התג ARRIVAL, המשמעות היא שציון הדרך בולט בסביבה וגם קרוב ליעד.

טיפוסים בני מנייה (enum)
TAG_UNSPECIFIED	לא בשימוש.
ADDRESS	מקום בולט מקומי שאפשר להשתמש בו כדי לזהות את המיקום הכללי של היעד. בדרך כלל בטווח של כמה מאות מטרים מהיעד. הם דומים לנקודות הציון שמוחזרות על ידי התכונה Address Descriptors (תיאורי כתובות) של Geocoding API: ‏ https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL	מקום שיכול לעזור להגיע ליעד. התכונה הזו שימושית לניווט כשמתקרבים ליעד. לדוגמה, ציון הדרך יכול להיות מקום שנמצא בצד השני של הרחוב מהיעד. בדרך כלל, נקודת ציון עם התג הזה קרובה יותר ליעד מאשר נקודות ציון עם התג ADDRESS.

NavigationPoint

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

שדות
navigation_point_token	string פלט בלבד. טוקן שאפשר להשתמש בו כדי לזהות את נקודת הניווט הזו.
display_name	LocalizedText השם המוצג של נקודת הניווט הזו. לדוגמה, '5th Ave' או 'Gate B'.
location	LatLng נקודה ליד מקטע הכביש שבו הניווט צריך להסתיים. הנקודה מוסטת בכוונה מעט מקו האמצע של הכביש כדי לסמן בבירור את הצד של הכביש שבו המקום ממוקם.
travel_modes[]	NavigationPoint.TravelMode מצבי נסיעה שמתאימים לנקודת הניווט הזו.
usages[]	NavigationPoint.Usage שימושים שנתמכים על ידי נקודת הניווט הזו.

TravelMode

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

טיפוסים בני מנייה (enum)
TRAVEL_MODE_UNSPECIFIED	לא בשימוש.
DRIVE	מתאים לנהיגה.
WALK	מתאים להליכה.

שימוש

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

טיפוסים בני מנייה (enum)
USAGE_UNSPECIFIED	לא בשימוש.
UNKNOWN	סוג השימוש לא ידוע. רוב נקודות הניווט יהיו UNKNOWN, וזה לא בהכרח אומר שהשימוש בהן מוגבל בצורה כלשהי. יכול להיות שהניווט הזה עדיין מתאים לאיסוף ו/או להורדה.
DROPOFF	מתאים להורדת נוסע. לדוגמה, מיקום להורדת נוסעים בנסיעה שיתופית.
PICKUP	מתאים לאיסוף נוסעים. לדוגמה, מיקום איסוף של נסיעה שיתופית.
PARKING	מתאים לחנייה. לדוגמה, בתוך חניון.

PlaceView

מייצג תצוגה של מקום ב-Places API. היא גם מספקת מידע נוסף שספציפי ליעדים, כמו סוג המבנה והמצולע שמוצג.

במקרים מסוימים, ערך של PlaceView עם אותו מזהה מקום עשוי להיות שונה ממה שמוחזר על ידי Places API בשדות types ו-display_name.

שדות
place	string שם המשאב של המקום הזה, בפורמט places/{placeId}.
display_name	LocalizedText תיאור קריא של המקום. לדוגמה, 'שער ב', 'מקדונלדס'
primary_type	string סוג המקום העיקרי של המקום הזה. רשימת הערכים האפשריים זמינה בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types. הערה: השדה הזה לא תמיד מאוכלס. במקרים כאלה, צריך להיות מוכנים להשתמש בשדה types.
types[]	string כל סוגי המקומות שמשויכים למקום הזה. רשימת הערכים האפשריים זמינה בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
formatted_address	string כתובת בשורה אחת.
postal_address	PostalAddress כתובת מובנית.
structure_type	PlaceView.StructureType סוג המבנה שמתאים למקום הזה.
location	LatLng המיקום של המקום הזה. במקומות שבהם מוצגים פוליגונים, אפשר להשתמש בהם כדי להציב סמן במפה.
display_polygon	Struct המתאר של הפוליגון של המקום בפורמט GeoJSON, בפורמט RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6. הערה: פורמט RFC 7946 תומך ב-MultiPolygons, כך שאובייקט display_polygon אחד יכול לייצג כמה מצולעים.

StructureType

סוג המבנה שהמקום הזה מייצג.

טיפוסים בני מנייה (enum)
STRUCTURE_TYPE_UNSPECIFIED	לא בשימוש.
POINT	מיקום נקודתי.
SECTION	חלק ממבנה.
BUILDING	מבנה.
GROUNDS	אזור גדול שבדרך כלל מכיל כמה בניינים, כמו קמפוס אוניברסיטאי, מתחם דירות או קניון.

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

SearchDestinationsRequest

בקשת הודעה עבור DestinationService.SearchDestinations.

שדות
travel_modes[]	NavigationPoint.TravelMode אופציונלי. אמצעי התחבורה שרוצים לסנן את נקודות הניווט לפי. הפעולה הזו משפיעה על השדה navigation_points שמוחזר בתגובה. אם לא מציינים ערך, אפשר להחזיר נקודות ניווט של כל אמצעי התחבורה.
language_code	string אופציונלי. השפה שצריך להחזיר בה את התוצאות.
region_code	string אופציונלי. קוד אזור. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. הפרמטר משפיע על התוצאות בהתאם לדין החל. הפרמטר הזה ישפיע גם על התוצאות מהשירות, אבל לא יגביל אותן באופן מלא.
שדה איחוד primary_query. שליחת שאילתה ליעד הראשי. יכול להיות שמדובר במקום, בכתובת מלאה או במיקום LatLng. לא ניתן להפוך ליעד חלק מהמקומות והכתובות שיש לגביהם מידע מינימלי. היעדים מבוססים על השאילתה הראשית שצוינה. הערה: המערכת תומכת רק במקומות ובכתובות שיכולים להיות יעד לניווט. לדוגמה, אפשר להשתמש במקום שמייצג בית או מתחם דירות כשאילתת החיפוש העיקרית, אבל אי אפשר להשתמש במקומות שמייצגים יישוב או אזור אדמיניסטרטיבי כשאילתת החיפוש העיקרית. הערך primary_query יכול להיות רק אחד מהבאים:
place	string שם המשאב של המקום, בפורמט places/{place_id}.
address_query	SearchDestinationsRequest.AddressQuery כתובת רחוב.
location_query	SearchDestinationsRequest.LocationQuery מיקום מדויק.

AddressQuery

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

שדות
שדה איחוד kind. שאילתת הכתובת. הערך kind יכול להיות רק אחד מהבאים:
address	PostalAddress כתובת רחוב בפורמט של כתובת למשלוח דואר.
address_query	string כתובת רחוב בפורמט של שורה אחת.

LocationQuery

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

הערה: אם שאילתת המיקום היא בתוך בניין שמכיל שטחי משנה, יכול להיות שהמקום הראשי שמוחזר הוא שטח משנה. במקרים כאלה, השדה containing_places יכלול את הבניין.

שדות
place_filter	SearchDestinationsRequest.LocationQuery.PlaceFilter אופציונלי. מסננים להחלה על מועמדים ליעד.
שדה איחוד kind. שאילתת המיקום. הערך kind יכול להיות רק אחד מהבאים:
location	LatLng מיקום מדויק של קו רוחב וקו אורך.

PlaceFilter

מסננים להחלה על מועמדים ליעד.

שדות
structure_type	PlaceView.StructureType אופציונלי. אם מציינים את סוג המבנה הזה, מובטח שלכל היעדים יהיה מקום ראשי עם סוג המבנה הזה. התוצאה יכולה להיות סינון של חלק מהיעדים או שינוי רמת הפירוט של היעדים שמוחזרים. לדוגמה, אם מציינים GROUNDS, כל יעדי החזרה יהיו עם מקום ראשי מסוג המבנה GROUNDS. התוצאה יכולה להיות סינון של חלק מהיעדים שלא נכללים בשטח, או החזרת יעדים ברמת השטח. שימוש נוסף בשדה הזה הוא כדי לחלץ בקלות רבה יותר מצולעים של בניינים שמוצגים בתצוגה. לדוגמה, אם מציינים את BUILDING, מצולע התצוגה של המקום הראשי יהיה של הבניין במיקום שצוין.
addressability	SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability אופציונלי. אם מציינים את הפרמטר הזה, הפונקציה מחזירה רק יעדים שעומדים בקריטריונים המתאימים של יכולת הכתובת.

אפשרות פנייה

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

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

SearchDestinationsResponse

הודעת התגובה של DestinationService.SearchDestinations.

שדות
destinations[]	Destination רשימת יעדים. השירות מחזיר תוצאה אחת אם אפשר לזהות באופן חד-משמעי יעד ראשי מתוך השאילתה הראשית. אחרת, השירות עשוי להחזיר כמה תוצאות כדי להבחין בין האפשרויות או אפס תוצאות.