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

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

פתרון בעיות

פתרון בעיות

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

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

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

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

אני זקוק לתשובות מהירות והקואורדינטות של הקואורדינטות איטיות מדי עבור הבקשה שלי. מה אפשר אני משתמש/ת בתשובות מהירות יותר?

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

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

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

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

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

איך אפשר לדווח על באגים בקואורדינטות של הכלי?

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

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

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

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

בקואורדינטות, סינון רכיבים אוכף רק 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. Country (מדינה) לא מובטח ששמות וקיצורים אחרים יניבו את אותן תוצאות שמתקבלות מקודי מדינות.

    דוגמאות:

    • קידוד גיאוגרפי עבור החזרות של 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 "Madrid, NM 87010, USA" אבל אף אחת מהערים האחרות בארה"ב ששמו "מדריד". 
      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