Package google.type

אינדקס

LatLng

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

שדות
latitude

double

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].
longitude

double

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

PostalAddress

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

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

עצות לגבי הזנת כתובות או עריכתן: - יש להשתמש בווידג'ט כתובות שמותאם לתרגום לשפות שונות, כמו https://github.com/google/libaddressinput. - אסור להציג למשתמשים רכיבי ממשק משתמש להזנה או לעריכה של שדות מחוץ למדינות שבהן השדה הזה נמצא בשימוש.

הנחיות נוספות לשימוש בסכימה הזו זמינות בכתובת: https://support.google.com/business/answer/6397478

שדות
revision

int32

גרסת הסכימה של PostalAddress. כל ערך שאינו 0 יגרום ל-API להחזיר שגיאה מסוג INVALID_ARGUMENT.
region_code

string

זה שינוי אופציונלי. קוד האזור במאגר CLDR של המדינה או האזור של הכתובת. פרטים נוספים זמינים בכתובות https://cldr.unicode.org/ ו-https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. דוגמה: 'CH' לשווייץ. אם לא מציינים את קוד האזור, הוא ינובע מהכתובת. כדי לשפר את הביצועים, מומלץ לכלול את קוד האזור אם אתם יודעים אותו. אזורים לא עקביים או חוזרים על עצמם עלולים להוביל לביצועים נמוכים. לדוגמה, אם address_lines כבר כולל את האזור, אין לספק שוב את קוד האזור בשדה הזה. מידע על אזורים נתמכים זמין בדף שאלות נפוצות.
language_code

string

קוד השפה בכתובת הקלט שמור לשימושים עתידיים והמערכת מתעלמת ממנו היום. ה-API מחזיר את הכתובת בשפה המתאימה למיקום שבו היא נמצאת.
postal_code

string

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

string

זה שינוי אופציונלי. קוד מיון נוסף, ספציפי למדינה. ברוב האזורים לא משתמשים באפשרות הזו. אם משתמשים בו, הערך יכול להיות מחרוזת כמו CEDEX, ואחריו מספר (למשל CEDEX 7), או רק מספר בלבד, שמייצג את 'קוד המגזר' (ג'מייקה), 'אינדיקטור אזור למשלוחים' (מלאווי) או 'אינדיקטור של סניף דואר' (למשל, חוף השנהב).
administrative_area

string

זה שינוי אופציונלי. הרמה המנהלית הגבוהה ביותר שמשמשת לכתובות דואר של מדינה או אזור. לדוגמה, יכול להיות שמדובר במדינה, במחוז, בפרובינציה או במחוז. באופן ספציפי, בספרד זהו המחוז ולא הקהילה האוטונומית (למשל, 'ברצלונה' ולא 'קטלוניה'). במדינות רבות לא נעשה שימוש באזור מנהלי בכתובות דואר. לדוגמה, בשווייץ לא צריך לאכלס את השדה הזה.
locality

string

זה שינוי אופציונלי. בדרך כלל מתייחס לחלק של העיר בכתובת. דוגמאות: עיר בארה"ב, עיר בבריטניה, יישוב בבריטניה. באזורים בעולם שבהם היישובים לא מוגדרים בצורה טובה או לא מתאימים למבנה הזה, משאירים את השדה locality ריק ומשתמשים ב-address_lines.
sublocality

string

זה שינוי אופציונלי. יישוב משנה של הכתובת. לדוגמה, אלה יכולים להיות שכונות, פרוורים או מחוזות.
address_lines[]

string

חובה. שורות כתובת לא מובנות שמתארות את הרמות הנמוכות יותר של הכתובת.

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

הייצוג המבני המינימלי המותר של כתובת מורכב מכל המידע שמופיע ב-address_lines. אם לא מציינים את השדה region_code, האזור נגזר משורות הכתובת.

מומלץ ליצור כתובת שמכילה רק את address_lines, ולאחר מכן קידוד גיאוגרפי הוא הדרך המומלצת לטיפול בכתובות לא מובנות לחלוטין (בניגוד לניחוש אילו חלקים של הכתובת צריכים להיות יישובים או אזורים מנהליים).
recipients[]

string

מומלץ להימנע מהגדרה של השדה הזה. בשלב הזה, לא נעשה בו שימוש ב-Address Validation API. בשלב הזה ה-API לא ידחה בקשות עם השדה הזה, אבל המידע יימחק ולא יוחזר בתשובה.
organization

string

מומלץ להימנע מהגדרה של השדה הזה. בשלב הזה, לא נעשה בו שימוש ב-Address Validation API. בשלב זה, ה-API לא ידחה בקשות עם השדה הזה מוגדר, אבל המידע יושלך לפח ולא יוחזר בתגובה.