Package google.maps.geocode.v4beta

אינדקס

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

GeocodeAddressRequest

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

שדות
location_bias

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[]

Granularity

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

Granularity

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

Viewport

אזור תצוגה שמתאים להצגת תוצאת ה-geocode.
bounds

Viewport

תיבה תוחמת (bounding box) של הכתובת.
formatted_address

string

הכתובת בפורמט של שורה אחת.
postal_address

PostalAddress

הכתובת בפורמט של כתובת למשלוח דואר.
address_components[]

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

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

פרטים נוספים זמינים בכתובת 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 כל השאר.

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