שאלות נפוצות בנושא קידוד גיאוגרפי

שאלות נפוצות אלה עוסקות בשאלות ספציפיות לגבי Geocoding API. כדאי לעיין בשאלות הנפוצות בנושא הפלטפורמה של מפות Google כדי לקבל תשובות לשאלות נפוצות בכל הפלטפורמות של מפות Google. למידע נוסף, ראו שיטות מומלצות לקידוד גיאוגרפי של כתובות.

פתרון בעיות

פתרון בעיות

אני מקבל יותר שאילתות שמחזירה ZERO_RESULTS עם המקודד הגיאוגרפי. מה קרה?

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

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

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

אני צריך תגובות מהירות והמקודד הגיאוגרפי איטי מדי לאפליקציה שלי. במה אפשר להשתמש כדי לתת תשובות מהירות יותר?

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

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

איך אפשר לקצר את זמן האחזור ב-Directions API וב-מרחק של מטריקס API?

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

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

כיצד ניתן לדווח על באגים במקודד הגיאוגרפי?

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

המקודד הגיאוגרפי לא מפיק תוצאות טובות בשביל התרחיש לדוגמה שלי. איך אפשר לקבל עזרה?

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

כיצד ניתן לקבל את התוצאות הטובות ביותר עם המקודד הגיאוגרפי באמצעות סינון רכיבים?

בכלי הקידוד הגיאוגרפי, סינון הרכיבים אוכף רק את ההגבלות postal_code ו-country. הדוגמאות הבאות ממחישות מהי הדרך הטובה ביותר להשתמש בסינון רכיבים, בהתאם לתוצאות הדרושות לך. בכתובות ה-URL של הבקשות לדוגמה, חשוב להחליף את 'YOUR_API_KEY' במפתח ה-API האמיתי שלך.

  • כדי להגביל את המיקודים במדינה ספציפית, צריך לציין את הגבלת המדינה באמצעות קוד מדינה לפי תקן ISO 3166-2. לדוגמה: הפונקציה components=country:CH|postal_code:8000 מחזירה את הערך "8000 ציריך, שוויץ". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • כדי להגביל שאילתות למדינה ספציפית, צריך לציין את הגבלת המדינה באמצעות קוד מדינה לפי תקן ISO 3166-2. לא בטוח ששמות של מדינות וקיצורים אחרים יניבו אותן תוצאות כמו קודי מדינות.

    דוגמאות:

    • הקידוד הגיאוגרפי עבור components=country:FRA|locality:gallus מחזיר את הרשות המוניציפאלית של גאלוס בפרנקפורט אם מיין, גרמניה. הסיבה לכך היא שקוד המדינה בן 3 האותיות של צרפת (FRA) לא נתמך, ולכן התוצאות מותרות בכל מדינה והתוצאה בפרנקפורט מתאימה יותר מכל דבר בצרפת. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • הממשק Geocoding API לא בהכרח יחזיר תוצאות מרובות עבור שאילתות לא חד משמעיות. שאילתות כאלה מקבלות מענה טוב יותר באמצעות התכונה 'השלמה אוטומטית של מקום'.

    דוגמאות:

    • הקידוד הגיאוגרפי של components=country:US|locality:madrid מחזיר את "מדריד, NM 87010, ארה"ב", אבל אף אחת מהערים האחרות בארה"ב בשם "מדריד". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • שימוש בהשלמה אוטומטית של מקום עבור input=madrid&components=country:us&types=(regions), וכן ציון אזור תצוגה המשתמש ב-location וב-radius כדי להטות את תוצאות המיקום, יוצר תגובה עם מספר ערים בארה"ב בשם "מדריד". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY