סקירה כללית על Geocoding API

מפתחים באזור הכלכלי האירופי (EEA)

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

למה כדאי להשתמש ב-Geocoding API

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

מה אפשר לעשות באמצעות Geocoding API

אפשר להשתמש ב-Geocoding API כדי לקבל נתוני קידוד גיאוגרפי של כתובת אחת או יותר או של מקומות אחדים או יותר, כולל:

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

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

איך Geocoding API פועל

Geocoding API מבצע גם המרת כתובות לקואורדינטות (geocoding) וגם המרת קואורדינטות לכתובות (reverse geocoding):

  • מיקום גיאוגרפי: המרת כתובות כמו ‎1600 Amphitheatre Parkway, Mountain View, CA‎ לקואורדינטות של קו הרוחב ואורך הגלובוס או למזהי מקומות. אפשר להשתמש בקואורדינטות האלה כדי להציב סמנים במפה, או כדי למרכז את המפה או לשנות את המיקום שלה בתוך מסגרת התצוגה.
  • המרת קואורדינטות לכתובות (reverse geocoding): המרת קואורדינטות של קווי רוחב ואורך או מזהה מקום לכתובת שאנשים יכולים לקרוא. אפשר להשתמש בכתובות במגוון תרחישים, כולל משלוחים או איסופים.

הדגמה הבאה משתמשת בשירות המרת כתובות לקואורדינטות (geocoding) דרך Maps JavaScript API כדי להמחיש איך Geocoding API פועל. אפשר לפתוח את המפה בכרטיסייה נפרדת כדי לראות אפשרויות ופרטים נוספים.

משאבים

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

מקורות נתונים הנתונים שהוחזרו פורמט ההחזרה
המרת כתובות לקואורדינטות (geocoding) הפונקציה מחזירה כתובת, רכיבי כתובת וסוגים של כתובות. מידע נוסף זמין בקטע תוצאות במדריך בקשה ותגובה לגיאוקוד.
  • JSON
  • XML
המרת קואורדינטות לכתובות (reverse geocoding) הפונקציה מחזירה כתובת, רכיבי כתובת וסוגים של כתובות. מידע נוסף זמין בקטע תשובות להמרת קואורדינטות לכתובות (reverse geocoding) במדריך בנושא בקשות ותשובות להמרת קואורדינטות לכתובות (reverse geocoding).
המרת מיקום של מקום לקואורדינטות הפונקציה מחזירה כתובת, רכיבי כתובת וסוגים של כתובות. מידע נוסף זמין בקטע תשובות להמרת קואורדינטות לכתובות (reverse geocoding) במדריך בנושא בקשות והתשובות להמרת קואורדינטות של מקומות.

איך משתמשים ב-Geocoding API

1 הגדרה מתחילים בהגדרת הפרויקט ב-Google Cloud ומבצעים את ההוראות להגדרה שמופיעות בהמשך.
2 שליחת בקשה לגיאוקוד אחרי שתקבלו מפתח API, תוכלו להתחיל לבדוק את Geocoding API ישירות מ-curl או מדפדפן. צריך לספק את פרמטרי החיפוש הנכונים לחיפוש כתובות או רכיבים. פרטים נוספים זמינים במאמר פרמטרים של גיאוקוד.
3 שליחת בקשה להמרת קואורדינטות לכתובות (reverse geocoding) כדי לקבל את רכיבי הכתובת של הכתובת הקרובה ביותר שניתנת לקריאה על ידי בני אדם במיקום הזה, צריך לספק את קואורדינטות קו האורך/הרוחב יחד עם מפתח ה-API. פרטים נוספים זמינים במאמר בקשות לפענוח גיאוגרפי הפוך.
4 הסבר על העקרונות הבסיסיים של תגובות כל נקודות הקצה ב-Geocoding API מחזירות את אותם נתונים בפורמט JSON או XML. במאמר תגובות לגיאוקוד מוסבר על הנתונים, קודי הסטטוס והודעות השגיאה.
5 הוספת נתוני קידוד גיאוגרפי לאפליקציה שלכם אפשר להשתמש בנתוני גיאוקודינג כדי לקבל כתובות מסמני מפה, או כדי לספק סמנים במפה על סמך כתובת ידועה.

ספריות הלקוח הזמינות

אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:

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

המאמרים הבאים