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

זמינות החנייה ביעד הזה.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

מתקני החניה ביעד הזה.
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 קשה מאוד למצוא חניה.

ParkingFacility

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

שדות
place

PlaceView

ייצוג המקום של מתקן החנייה הספציפי הזה.
onsite

bool

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

bool

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

double

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

כניסה

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

שדות
display_name

LocalizedText

שם קריא לאנשים, למשל "שער ב'", "כניסה דרומית", "כניסה משדרת 5".
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

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

הרשימה המלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' בכתובת 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

קבוצה של תגי סוג לתוצאה הזו. לדוגמה, "political" ו-"administrative_area".

הרשימה המלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' בכתובת 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

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

הערכים האלה נלקחים מהטבלה של סוגי הכתובות וסוגי הרכיבים של הכתובות שמשמשת את Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

רמת פירוט

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

טיפוסים בני מנייה (enum)
GRANULARITY_UNSPECIFIED אין להשתמש בו.
ROOFTOP המיקום הלא-אינטרפולטיבי של חלקת אדמה בפועל שתואמת לכתובת שנמצאה.
RANGE_INTERPOLATED אינטרפולציה מטווח של מספרי בתים. לדוגמה, אם אנחנו יודעים שקטע מסוים של רחוב דיזנגוף מכיל את המספרים 100-199, אז המספר 150 עשוי להיות ממוקם באמצע הדרך בין נקודות הקצה שלו.
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 מקום בולט באזור שיכול לשמש לזיהוי המיקום הכללי של היעד. בדרך כלל במרחק של כמה מאות מטרים מהיעד. הם דומים לנקודות הציון שמוחזרות על ידי התכונה "תיאורי כתובות" של Geocoding API: ‏https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL מקום שיכול לעזור להגיע ליעד. התכונה הזו שימושית לניווט כשמתקרבים ליעד. לדוגמה, נקודת הציון הזו יכולה להיות מקום שנמצא מעבר לרחוב מהיעד. ציון דרך עם התג הזה בדרך כלל קרוב יותר ליעד מאשר ציוני דרך עם התג ADDRESS.

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

שדות
navigation_point_token

string

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

LocalizedText

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

מייצג תצוגה של מקום ב-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 תומך במרובה-פוליגונים, כך שאובייקט display_polygon אחד יכול לייצג כמה פוליגונים.
address_components[]

PlaceView.AddressComponent

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

AddressComponent

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

שדות
long_text

string

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

string

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

string

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

הערכים האלה נלקחים מהטבלה של סוגי הכתובות וסוגי הרכיבים של הכתובות שמשמשת את Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-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/8,000 על 1/8,000 מעלות (כ-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

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

int32

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

float

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

float

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

float

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