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) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. אפשר לעיין בתוצאות במדריך בנושא בקשה ותגובה של קידוד גיאוגרפי. |
|
| המרת קואורדינטות לכתובות (reverse geocoding) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. מידע נוסף זמין במדריך בנושא בקשות ותשובות של המרת קואורדינטות לכתובות בקטע תשובות של המרת קואורדינטות לכתובות. | |
| המרה של כתובת המיקום לקואורדינטות (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 Client for Google Maps Services
- Python Client for Google Maps Services
- Go Client for Google Maps Services
- Node.js Client for Google Maps Services
הלקוחות של Java, Python, Go ו-Node.js עבור Google Maps Services הם ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
- מתחילים להשתמש ב-Geocoding API: עוברים אל הגדרת פרויקט ב-Google Cloud.
- איך מתחילים לעבוד עם דוגמאות לבקשות ולתשובות: עוברים אל בקשות ותשובות של קידוד גיאוגרפי
- יישום שיטות מומלצות: אפשר לעיין בשיטות מומלצות לגיאו-קידוד של כתובות.