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

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

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

באופן כללי, יש להשתמש ב-geocoding API כשמבצעים קידוד גיאוגרפי של כתובות מלאות (לדוגמה, "48 Pirrama Rd, Pyrmont, NSW, Australia"). שימוש ב-places API Place השלמה אוטומטית של כתובות כאשר כתובות עם קידוד גיאוגרפי לא חד-משמעי (לא הושלם) או באפליקציות רגישות לזמן אחזור, כמו בעת תגובה לקלט של משתמש.

תרחישים לדוגמה והמלצות API

תרחישים לדוגמה והמלצות API
מענה בזמן אמת לקלט של משתמש (כולל כתובות הקשר לא ברורות, חלקיות, בפורמט שגוי או עם שגיאות איות שהוזנו על ידי המשתמש) משתמשים בשירות 'השלמה אוטומטית של מקומות ב-API' כדי לקבל מזהה מקום, ולאחר מכן בממשק ה-API של המרת כתובות לקואורדינטות (geocoding) כדי להפוך את מזהה המקום לקוד latlng.
עיבוד מערכות אוטומטיות מלא, לא ברור, כתובות למשלוח דואר (לדוגמה, "48 Pirrama Rd, Pyrmont, NSW, Australia") אתם יכולים להשתמש בשירות האינטרנט המרת API ל-API.
מערכות אוטומטיות שמעובדות שאילתות מעורפלות (לדוגמה, כתובות חלקיות, כתובות בפורמט שגוי או כתובות עם שגיאות איות) מומלץ להשתמש במערכות אוטומטיות בשירות האינטרנט Geocoding API. עם זאת, מערכות אוטומטיות עם שיעור גבוה של שאילתות לא ברורות, חלקיות או מעוותות בשגיאות שנגזרות מקלט של משתמשים עשויות ליהנות מהוספת ווידג'ט אינטראקטיבי להשלמה אוטומטית של מקומות כדי לאפשר למשתמשים לבחור תוצאה ולמנוע את שגיאת הכתובת.
בעיות של זמן אחזור באמצעות המסלולים מ-API או חוק מטריצת מרחקים, עם מקורות, יעדים או ציוני דרך שצוינו כמחרוזות כתובת יש לקצר את זמן האחזור של קוד הקידוד הגיאוגרפי באמצעות שירות ההשלמה האוטומטית של מקומות Google API כדי לקבל מזהי מקומות, ולאחר מכן להעביר את מזהי המקומות אל מסלול ה-API או המרחק מטריצת API.

תגובה לקלט של משתמש

לאפליקציות שמגיבות בזמן אמת לקלט של משתמשים יש שני שיקולים עיקריים שמשפיעים על בחירת ה-API:

  1. בדרך כלל צריך להזין כתובת בהדרגה (כמו "הרחוב הראשי 123"), ולכן כדאי להוסיף כתובות URL לא מלאות או לא ברורות כי הן עוזרות למשתמשים לקבל תוצאה מהר יותר.
  2. אפליקציות שמגיבות לקלט של משתמשים הן רגישות ביותר לזמן אחזור.

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

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

מידע נוסף על שירות ההשלמה האוטומטית של מקומות Android, iOS, JavaScript, ו- Places API.

מערכות אוטומטיות

עיבוד אוטומטי של מערכות מלאות, חד-משמעיות של כתובות דואר: שאילתות חד-משמעיות כמו מחרוזות כתובות מלאות (לדוגמה, "48 Pirrama Rd, Pyrmont, NSW, Australia") מטופלים בצורה הטובה ביותר על ידי שירות האינטרנט API ל-geocoding. הקצה העורפי של הקוד הגיאוגרפי של הכתובות מספק כיסוי רחב יותר של כתובות בכל העולם, ועובר אופטימיזציה להשגת תוצאות איכותיות יותר עם שאילתות מלאות וחד-משמעיות.

שאילתות אוטומטיות לא ברורות במערכת: שאילתות לא ברורות הן שאילתות שכוללות כתובות בפורמט שגוי, כתובות לא מלאות או שגיאות איות. לגבי מערכות אוטומטיות, מומלץ להשתמש בשירות האינטרנט המרת API ל-API. עם זאת, ה-API של Geocoding לא מיועד להתמודד עם שאילתות מעורפלות, והוא עשוי להניב תוצאות פחות מדויקות או אפס תוצאות בתגובה לשאילתות לא ברורות. אם המערכת האוטומטית שלך מעבדת שיעור גבוה של שאילתות מעורפלות שנגזרות מקלט של משתמשים, מומלץ להוסיף לאפליקציה רכיב אינטראקטיבי באמצעות שירות ההשלמה האוטומטית של מקומות ב-API של מקומות, מאחר שהוא נועד להחזיר מספר אפשרויות אפשריות ולאפשר למשתמשים לבחור בין כולן. ממשק ה-API של מקומות Google מחזיר מזהה מקום שניתן להעביר כמיקום ברור לשירות האינטרנט של המרת קידוד גיאוגרפי. לאחר מכן, הוא מחזיר את פרטי הכתובת המלאים ומוסיף את כתובת ה-URL לקואורדינטות של קוד הקואורדינטות. מידע נוסף על שירות ההשלמה האוטומטית של מקומות Android, iOS, JavaScript, ו- Places API.

הפחתת זמן האחזור ל-DIRECTION API ול-המרחק של מטריצת ה-API

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

אם האפליקציה שלך משתמשת ב-DIRECTION API או ב- חוק מטריצת המרחק במצב רגיש, כמו תגובה לקלט של משתמש, והמקורות, היעדים או ציוני הדרך שצוינו בהתחלה כמחרוזות כתובת מומלץ לצמצם את זמן האחזור באמצעות שירות ההשלמה האוטומטית של מקומות ב-Locations API כדי להמיר מחרוזות כתובת למזהי מקומות ולאחר מכן להעביר את מזהי המקומות ל-DIRECTION של ה-API או ל-API של מטריצת המרחקים. מידע נוסף על שירות ההשלמה האוטומטית של מקומות ל-Android, iOS, JavaScript, ו- Places API. אפשר גם לראות דוגמה ל-JavaScript של השלמה אוטומטית ומסלולים.

סיכום

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

ניהול שגיאות וניסיונות חוזרים

אם קיבלת UNKNOWN_ERROR תגובות, הן נובעות משגיאות זמניות ומטופלות שוב לאחר זמן קצר. אנחנו ממליצים להשתמש בספריות הלקוח של שירותי הפלטפורמה של מפות Google, שכוללות לוגיקה של ניסיון חוזר ותומכות באימות של תוכנית הפרימיום של מפות Google. לקוחות Java, Python Client, Go Client ו-Node.js Client עבור שירותי מפות Google הם ספריות לקוח נתמכות בקהילה, שזמינות להורדה ולתרומות ב-GitHub. שם אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

אם תתקבל קוד סטטוס OVER_QUERY_LIMIT בתור תגובה, חרגת ממגבלות השימוש ב-API. מומלץ לנסות את אסטרטגיות האופטימיזציה לשימוש האלה.