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