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