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