Package google.maps.geocode.v4alpha

אינדקס

DestinationService

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

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

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.destinations

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

נקודות ניווט ליעד הזה.
parking_options

Destination.ParkingOptions

אפשרויות חנייה ביעד הזה.
arrival_summary

Destination.ArrivalSummary

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

ArrivalSummary

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

שדות
text

LocalizedText

סיכום של חוויית ההגעה ליעד.
flag_content_url

string

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

LocalizedText

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

ParkingOptions

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

שדות
availability

Destination.ParkingOptions.Availability

זמינות החניה ביעד הזה.
onsite_parking

bool

יש חניה במקום היעד.
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

יש חניון בתשלום.

זמינות

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

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

טיפוסים בני מנייה (enum)
AVAILABILITY_UNSPECIFIED אין מידע על זמינות חנייה.
PLENTY יש הרבה מקומות חניה.
SOMEWHAT_DIFFICULT קצת קשה למצוא חנייה.
DIFFICULT קשה מאוד למצוא חנייה.

כניסה

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

שדות
location

LatLng

המיקום של הכניסה.
tags[]

Entrance.Tag

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

string

המבנה שבו הכניסה ממוקמת פיזית, בפורמט places/{place_id}.
street_view_thumbnail

StreetViewThumbnail

תמונה ממוזערת של Street View שבה מוצגת הכניסה. אפשר לבקש את התמונה מ-Street View Static API. מידע נוסף מופיע כאן: https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

הערה לגבי הכניסה ב-street_view_thumbnail שמוחזר למעלה.

תג

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

טיפוסים בני מנייה (enum)
TAG_UNSPECIFIED לא בשימוש.
PREFERRED

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

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

ImageAnnotation

הערה על תמונה ממוזערת, כמו מצולע שמתווה כניסה.

שדות
coordinates[]

ImageAnnotation.Coordinate

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

קואורדינטה

קואורדינטת הפיקסל של נקודה בתמונה. נקודת המוצא (0,0) היא הפינה השמאלית העליונה של הפיקסל השמאלי העליון בתמונה, כאשר ציר ה-x מצביע ימינה וציר ה-y מצביע למטה.

שדות
x_px

float

קואורדינטת X.
y_px

float

קואורדינטת Y.

ציון דרך

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

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

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

שדות
navigation_point_token

string

פלט בלבד. טוקן שאפשר להשתמש בו כדי לזהות את נקודת הניווט הזו.
display_name

LocalizedText

השם המוצג של נקודת הניווט הזו. לדוגמה, '5th Ave' או 'Gate B'.
location

LatLng

נקודה ליד מקטע הכביש שבו הניווט צריך להסתיים. הנקודה מוסטת בכוונה מעט מקו האמצע של הכביש כדי לסמן בבירור את הצד של הכביש שבו המקום ממוקם.
travel_modes[]

NavigationPoint.TravelMode

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

NavigationPoint.Usage

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

StreetViewThumbnail

תמונה ממוזערת של Street View שבה מוצגת נקודת הניווט, אם היא זמינה. אפשר לבקש את התמונה מ-Street View Static API. מידע נוסף מופיע כאן: https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

הערה לגבי הכניסה שמשויכת לנקודת הניווט הזו ב-street_view_thumbnail שמוחזר למעלה, אם זמינה.
altitude_meters

float

הגובה של נקודת הניווט במטרים ביחס לאליפסואיד WGS-84.

TravelMode

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

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

שימוש

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

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

PlaceView

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

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

שדות
place

string

שם המשאב של המקום הזה בפורמט places/{placeId}. אפשר להשתמש בו כדי לחפש את המקום.
place_id

string

המזהה הייחודי של מקום.
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 אחד יכול לייצג כמה מצולעים.
address_components[]

PlaceView.AddressComponent

רכיבים שחוזרים על עצמם בכל רמת מקומיות.

AddressComponent

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

שדות
long_text

string

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

string

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

string

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

פרטים נוספים זמינים במאמר /maps/documentation/geocoding/requests-geocoding#Types.
language_code

string

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

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

רשימת יעדים.

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

StreetViewThumbnail

פרמטרים לייצוג תמונה ממוזערת של Google Street View. אפשר להשתמש בפרמטרים האלה כדי לבקש תמונה של Street View מ-Street View Static API. מידע נוסף מופיע כאן: https://developers.google.com/maps/documentation/streetview/request-streetview.

שדות
pano

string

מזהה פנורמה ספציפי.
width_px

int32

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

int32

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

float

הכיוון האופקי של המצלמה במעלות. הטווח [0, 360). ‫0 מציין צפון ו-90 מציין מזרח.
pitch_degree

float

הכיוון האנכי של המצלמה במעלות. הטווח הוא [‎-90, 90]. ‫0 הוא קו האופק, ‎+90 הוא ישר למעלה, ‎-90 הוא ישר למטה.
fov_degree

float

שדה הראייה האופקי במעלות. טווח (0, 180]. שליטה ברמת הזום. שדה ראייה קטן יותר אומר שהתמונה תהיה מוגדלת יותר.