Geocoding API הוא שירות שמקבל מקום ככתובת, כקואורדינטות של קו רוחב וקו אורך או כמזהה מקום. הפונקציה ממירה כתובת לקואורדינטות של קו רוחב וקו אורך ולמזהה מקום, או ממירה קואורדינטות של קו רוחב וקו אורך או מזהה מקום לכתובת.
מה אפשר לעשות עם Geocoding API
אפשר להשתמש ב-Geocoding API כדי לקבל נתוני קידוד גאוגרפי של כתובת אחת או יותר או של מקומות, כולל:
- קואורדינטות גיאוגרפיות של כתובות.
- כתובות עבור קבוצות קואורדינטות של קווי רוחב ואורך.
- כתובות של מזהי מקומות.
אתם יכולים לקבוע איפה התוצאות יופיעו ולהגביל את התוצאות לאזור, למחוז או למיקוד מסוימים.
איך Geocoding API פועל
Geocoding API מבצע גם המרת כתובות לקואורדינטות (geocoding) וגם המרת קואורדינטות לכתובות (reverse geocoding):
- המרת כתובות לקואורדינטות (geocoding): המרה של כתובות כמו "1600 Amphitheatre Parkway, Mountain View, CA" לקואורדינטות של קווי רוחב ואורך או למזהי מקומות. אפשר להשתמש בקואורדינטות האלה כדי להציב סמנים במפה, או כדי למרכז או למקם מחדש את המפה בתוך מסגרת התצוגה.
- המרת קואורדינטות לכתובות (reverse geocoding): המרה של קואורדינטות של קווי רוחב וקווי אורך או של מזהה מקום לכתובת קריאה לאנשים. אפשר להשתמש בכתובות למגוון תרחישים, כולל משלוחים או איסופים.
בהדגמה הבאה נעשה שימוש בשירות המרת כתובות לקואורדינטות (geocoding) דרך Maps JavaScript API כדי להמחיש איך Geocoding API פועל. אפשר לפתוח את המפה בכרטיסייה נפרדת כדי לראות עוד אפשרויות ופרטים.
משאבים
בטבלה הבאה מפורטים המשאבים שזמינים דרך Geocoding API, לצד הנתונים שכל שיטה מחזירה.
| מקורות נתונים | הנתונים שהוחזרו | פורמט ההחזרה |
|---|---|---|
| המרת כתובות לקואורדינטות (geocoding) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. אפשר לעיין בתוצאות במדריך בנושא בקשה ותגובה של המרת כתובות לקואורדינטות (geocoding). |
|
| המרת קואורדינטות לכתובות (reverse geocoding) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. אפשר לעיין בתשובות של המרת קואורדינטות לכתובות במדריך בנושא בקשות ותשובות של המרת קואורדינטות לכתובות. | |
| המרת כתובות לקואורדינטות (geocoding) של מקומות | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. מידע נוסף זמין במדריך בנושא בקשות ותשובות של המרת קואורדינטות לכתובות (reverse geocoding) בקטע תשובות של המרת קואורדינטות לכתובות. |
איך משתמשים ב-Geocoding API
| 1 | איך מגדירים את התכונה | מתחילים עם הגדרת פרויקט ב-Google Cloud ומשלימים את הוראות ההגדרה שבהמשך. |
| 2 | איך שולחים בקשה להמרת כתובות לקואורדינטות (geocoding) | אחרי שמקבלים מפתח API, אפשר להתחיל לבדוק את Geocoding API ישירות מ-curl או מדפדפן. תצטרכו לספק את פרמטרי החיפוש הנכונים לחיפושים של כתובות או רכיבים. פרטים נוספים זמינים במאמר בנושא פרמטרים של המרת כתובות לקואורדינטות (geocoding). |
| 3 | ניסיון לשלוח בקשה להמרת קואורדינטות לכתובות (reverse geocoding) | כדי לקבל רכיבי כתובת של הכתובת הקרובה ביותר שניתנת לקריאה אנושית עבור מיקום מסוים, צריך לספק קואורדינטות של קו רוחב וקו אורך יחד עם מפתח ה-API. פרטים נוספים זמינים במאמר בנושא המרת קואורדינטות לכתובות (reverse geocoding). |
| 4 | הסבר על תשובות | כל השיטות ב-Geocoding API מחזירות את אותם נתונים בפורמט JSON או XML. הסבר על הנתונים, קודי הסטטוס והודעות השגיאה מופיע במאמר בנושא תגובות להמרת כתובות לקואורדינטות (geocoding). |
| 5 | שילוב נתונים של המרת כתובות לקואורדינטות (geocoding) באפליקציה שלכם | אתם יכולים להשתמש בנתוני המרת כתובות לקואורדינטות (geocoding) כדי לקבל כתובות מסמנים במפה או כדי לספק סמנים במפה על סמך כתובת ידועה. |
ספריות לקוח זמינות
אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:
- Java Client for Google Maps Services
- Python Client for Google Maps Services
- Go Client for Google Maps Services
- Node.js Client for מפות Google Services
הלקוחות של Java, Python, Go ו-Node.js עבור Google Maps Services הם ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
- מתחילים להשתמש ב-Geocoding API: עוברים אל הגדרת פרויקט בענן ב-Google Cloud.
- איך מתחילים לעבוד עם דוגמאות לבקשות ולתשובות: עוברים אל בקשות ותשובות של המרת כתובות לקואורדינטות (geocoding)
- יישום שיטות מומלצות: אפשר לעיין בשיטות מומלצות להמרת כתובות לקואורדינטות (geocoding) של כתובות.