קידוד גיאוגרפי הוא התהליך של המרת כתובות (כמו כתובת רחוב) לקואורדינטות גיאוגרפיות (קווי רוחב ואורך), שבהן ניתן להשתמש כדי להציב סמנים במפה או למקם את המפה. המסמך הזה מתמקד בהבהרת השיקולים הכרוכים בקביעת הקידוד הגיאוגרפי של כתובות. כאן מוסבר מתי כדאי להשתמש ב-Geocoding API ומתי כדאי להשתמש בשירות של Google Places API להשלמה אוטומטית של מיקומים.
באופן כללי, מומלץ להשתמש ב-Geocoding API כאשר מזינים קידוד גיאוגרפי של כתובות מלאות (לדוגמה, " 48 Pirrama Rd, Pyrmont, NSW, Australia"). יש להשתמש בשירות של Places API להשלמה אוטומטית כאשר קידוד גיאוגרפי של כתובות (כתובות לא מלאות) או עבור אפליקציות שתלויות בזמני אחזור, כמו כשמגיבים לקלט של משתמש.
תרחישים לדוגמה והמלצות ל-API
| תרחישים לדוגמה והמלצות ל-API | |
|---|---|
| שליחת תשובות בזמן אמת לקלט של משתמשים (כולל כתובות לא ברורות, חלקיות, כתובות בפורמט שגוי או כתובות שאויתו בצורה שגויה על ידי המשתמש) | משתמשים בשירות של Google Places API להשלמה אוטומטית של מיקומים כדי לקבל מזהה מקום. לאחר מכן, ניתן להשתמש ב-Geocoding API כדי ליצור קידוד גיאוגרפי של מזהה המקום ל-latlng. |
| מערכות אוטומטיות שמעבדות כתובות דואר מלאות, חד-משמעיות, למשלוח דואר (לדוגמה, " 48 Pirrama Rd, Pyrmont, NSW, Australia") | משתמשים בשירות האינטרנט של Geocoding API. |
| מערכות אוטומטיות שמעבדות שאילתות לא ברורות (לדוגמה, כתובות חלקיות, כתובות בפורמט שגוי או כתובות עם שגיאות איות) | מומלץ שמערכות אוטומטיות ישתמשו בשירות האינטרנט של Geocoding API. עם זאת, מערכות אוטומטיות עם שיעור גבוה של שאילתות דו-משמעיות, חלקיות או שגויות שנגזרות מקלט של משתמש, יכולות להפיק תועלת מהוספת ווידג'ט אינטראקטיבי להשלמה אוטומטית של מקום כדי לאפשר למשתמשים לבחור תוצאה וכך להימנע מאיות שגוי של כתובת. |
| בעיות זמן אחזור באמצעות Directions API או Formula Matrix API, עם מקורות, יעדים או ציוני דרך שצוינו כמחרוזות כתובת | אפשר לקצר את זמן האחזור של הקידוד הגיאוגרפי באמצעות Places API Place |
תגובה לקלט של משתמשים
לאפליקציות שמגיבות בזמן אמת לקלט של משתמשים יש שני שיקולים עיקריים שמשפיעים על הבחירה ב-API:
- קלט של משתמשים בדרך כלל כרוך בהזנת כתובת בהדרגה (לדוגמה, "123 רחוב ראשי"),
- אפליקציות שמגיבות לקלט של משתמשים הן רגישות מאוד לזמן אחזור.
שני שיקולים אלה הופכים את שירות ההשלמה האוטומטית של מקום ב-Place API לאידיאלי לתרחיש לדוגמה של מענה לקלט של משתמשים. ההשלמה האוטומטית של מקומות נועדה להחזיר מספר אפשרויות אפשריות ולאפשר למשתמש לבחור ביניהן. ניתן להגביל את ממשק ה-API של מקומות Google לחיפוש בלבד, למיקומים גיאוגרפיים או לכתובות, ובמקביל מחריגים עסקים. בנוסף, ניתן להטות את פונקציית החיפוש של ההשלמה האוטומטית כך שתחזיר תוצאות ספציפיות למיקום. Places API מחזיר מזהה מקום שאפשר להעביר אל שירות האינטרנט של Geocoding API באופן מלא אפשר להעביר את מזהי המקומות גם לממשקי API אחרים, כמו Directions API ו-מרחק Matrix API (ראו בהמשך).
לקידוד הגיאוגרפי של כתובות ב-Geocoding API יש זמן אחזור גבוה בהרבה, והוא גם מניב תוצאות פחות מדויקות לשאילתות לא שלמות או לא חד-משמעיות. לכן לא מומלץ לאפליקציות שצריכים להגיב בזמן אמת לקלט של משתמשים.
למידע נוסף על שירות ההשלמה האוטומטית של מקומות עבור Android, iOS, JavaScript, ו- Places API.
מערכות אוטומטיות
מערכות אוטומטיות שמעבדות כתובות דואר מלאות וחד-משמעיות: הטיפול הטוב ביותר בשאילתות חד-משמעיות, כמו מחרוזות מלאות של כתובות למשלוח דואר (לדוגמה, ' 48 Pirrama Rd, Pyrmont, NSW, Australia), מטופל בצורה הטובה ביותר על ידי שירות האינטרנט של Geocoding API. הקצה העורפי של קידוד גיאוגרפי של כתובות מספק כיסוי רחב יותר של כתובות בכל העולם, ועבר אופטימיזציה להשגת תוצאות באיכות גבוהה באמצעות שאילתות כאלה מלאות וחד-משמעיות.
שאילתות לא ברורות על ידי מערכת אוטומטית: שאילתות לא ברורות הן שאילתות שמכילות כתובות בפורמט לא תקין, כתובות חלקיות או שגיאות איות. במערכות אוטומטיות, מומלץ להשתמש ב שירות האינטרנט של Geocoding API. עם זאת, ה-Geocoding API לא נועד להתמודד עם שאילתות לא ברורות, והוא עשוי להניב תוצאות פחות מדויקות או אפס תוצאות בתגובה לשאילתות לא ברורות. אם המערכת האוטומטית שלך מעבדת שיעור גבוה של שאילתות לא חד-משמעיות שנגזרות מקלט של משתמש, כדאי להוסיף לאפליקציה רכיב אינטראקטיבי באמצעות השירות של השלמה אוטומטית במקומות ב-Place API, כי הוא נועד להחזיר אפשרויות מרובות ולאפשר למשתמש לבחור ביניהן. ה-Places API מחזיר מזהה מקום שאותו אפשר להעביר כמיקום חד-משמעי אל שירות האינטרנט של Geocoding API. לאחר מכן, מחזיר את פרטי הכתובת המלאים ומקודד את הכתובת גיאוגרפית ל-latlng. למידע נוסף על שירות ההשלמה האוטומטית של מקומות עבור Android, iOS, JavaScript, ו- Places API.
קיצור זמן האחזור ל-Directions API ול-Remote Matrix API
כשמקורות, יעדים או ציוני דרך מצוינים כמחרוזות כתובת, Directions API ו- מרחק Matrix API משתמשים באותו קצה עורפי של ה-Geocoding API כדי לקבוע את המיקום הגיאוגרפי של הכתובות האלה לפני חישוב המסלול. אפשרות זו מגדילה משמעותית את זמן האחזור בהשוואה לציון אותם מיקומים כמו latlngs או מזהי מקום.
אם האפליקציה שלך משתמשת ב-Directions API או ב- לחן מטריקס API בסיטואציות שונות של זמן אחזור, כמו תגובה לקלט של משתמשים, והמקורות, היעדים או ציוני הדרך שלכם מצוינים בהתחלה כמחרוזות כתובת, מומלץ לצמצם את זמן האחזור באמצעות השירות Place השלמה אוטומטית של Places API כדי להמיר מחרוזות כתובות למזהי מקומות, ואז להעביר את מזהי המקומות ל-Directions API או ל-מרחק Matrix API. למידע נוסף על שירות ההשלמה האוטומטית של מקומות עבור Android, iOS, JavaScript ו- Places API. ראה גם דוגמה JavaScript להשלמה אוטומטית של מקום ולמסלול הגעה.
סיכום
בהתאם לתרחיש השימוש שלכם, בעת קידוד גיאוגרפי של כתובות, השימוש ב-Geocoding API או השימוש בשירות ההשלמה האוטומטית של מקום בשילוב עם ה-Geocoding API מאפשרים ליצור אפליקציות שמציעות למשתמשים תוצאות מדויקות של קידוד גיאוגרפי וכן קיצור זמן האחזור.
ניהול שגיאות וניסיונות חוזרים
אם מתקבלות UNKNOWN_ERROR תגובות, הן נגרמות משגיאות זמניות,
ומומלץ לנסות שוב אחרי השהיה קצרה כדי לטפל בהן. מומלץ להשתמש ב
ספריות הלקוח של שירותי האינטרנט בפלטפורמה של מפות Google, שכוללות לוגיקה של ניסיונות חוזרים ותומכות באימות בתוכנית הפרימיום של הפלטפורמה של מפות Google.
לקוח Java, לקוח Python, לקוח Go ו-Node.js Client לשירותי מפות Google הן ספריות לקוח שנתמכות על ידי הקהילה. הן זמינות להורדה ולתרומות ב-GitHub, שם תמצאו גם הוראות התקנה וקוד לדוגמה.
אם קיבלת בתגובה קוד סטטוס OVER_QUERY_LIMIT, המשמעות היא
שחרגת ממגבלות השימוש ב-API. מומלץ לנסות את
האסטרטגיות האלה לאופטימיזציית השימוש.