API לקידוד גיאוגרפי

ה-geocoding API הוא שירות שמקבל מקום ככתובת, בקואורדינטות של קווי אורך ורוחב או במזהה מקום. הוא ממיר את הכתובת לקואורדינטות של קווי אורך ורוחב ולמזהה מקום, או ממיר לכתובת של קו אורך וקו אורך או מזהה מקום לכתובת.

למה כדאי להשתמש ב-geocoding API

אם רוצים להשתמש בנתוני קידוד גיאוגרפי במפות בתוך אחד מממשקי ה-API של הפלטפורמה של מפות Google, צריך להשתמש ב-API של קידוד גיאוגרפי עבור אתרים. באמצעות ה-API של קידוד גיאוגרפי, משתמשים בכתובות כדי למקם סמנים במפה, או להמיר את הסמן במפה לכתובת מסוימת. השירות הזה מיועד לקידוד גיאוגרפי של כתובות סטטיות מוגדרות מראש למיקום תוכן של אפליקציות במפה.

מה אפשר לעשות עם Geocoding API

ניתן להשתמש ב-geocoding API כדי לקבל נתוני קידוד גיאוגרפי עבור כתובת אחת או יותר או מקום אחד, כולל:

  • קואורדינטות גיאוגרפיות של כתובות.
  • כתובות לקבוצות של קואורדינטות רוחב ואורך.
  • כתובות של מזהי מקומות.

אפשר לקבוע איפה יופיעו התוצאות ולהגביל את התוצאות לאזור, למחוז או למיקוד מסוימים.

איך פועל ה-API לקידוד גיאוגרפי

ממשק ה-API לקידוד גיאוגרפי מבצע קידוד גיאוגרפי וגם קידוד גיאוגרפי:

  • קידוד גיאוגרפי: מתבצעת המרה של כתובות כמו '1600 Amphitheatre Parkway, Mountain View, CA' לקואורדינטות של קווי אורך ורוחב או מזהי מקום. אפשר להשתמש בקואורדינטות האלה כדי למקם סמנים במפה, או למרכז את המפה או למקם אותה מחדש בתוך מסגרת התצוגה.
  • היפוך קוד גיאוגרפי: המרת קואורדינטות של קווי אורך ורוחב או מזהה מקום לכתובת שניתנת לקריאה על ידי אנשים. אפשר להשתמש בכתובות למגוון תרחישים, כולל משלוחים או איסופים.

בהדגמה הבאה נעשה שימוש בשירות Geocoding API דרך Maps JavaScript API, כדי להמחיש את אופן הפעולה של Geocoding API. אפשר לפתוח את המפה בכרטיסייה נפרדת כדי לראות אפשרויות נוספות ופרטים נוספים.

משאבים

בטבלה הבאה מופיע סיכום של המשאבים הזמינים דרך Geocoding API לצד הנתונים שמוחזרים מנקודות הקצה.

מקורות מידע הנתונים שהוחזרו פורמט החזרה
קידוד גיאוגרפי מחזירה כתובת, רכיבי כתובת וסוגים של כתובות. אפשר לקרוא את המאמר תוצאות במדריך בקשה ותגובה לקידוד גיאוגרפי.
  • JSON
  • XML
המרת קואורדינטות לכתובות (reverse geocoding) מחזירה כתובת, רכיבי כתובת וסוגים של כתובות. אפשר לעיין בתשובות הפוך לקידוד גיאוגרפי במדריך בקשה ותגובה לקידוד גיאוגרפי.
מיקום גיאוגרפי מחזירה כתובת, רכיבי כתובת וסוגים של כתובות. כדאי לעיין בתשובות הפוך לקידוד גיאוגרפי במדריך שליחת בקשה לקידוד גיאוגרפי ותשובה.

איך משתמשים ב-API של קידוד גיאוגרפי

1 עליכם להגדיר את החשבון שלכם. בשלב הראשון, מגדירים את הפרויקט ב-Google Cloud ומשלימים את ההוראות להגדרה.
2 יצירת בקשה לקידוד גיאוגרפי אחרי שתקבלו מפתח API, תוכלו להתחיל לבדוק את Geocoding API ישירות מתוך cURL או דפדפן. תצטרכו לספק את הפרמטרים הנכונים לחיפוש במהלך חיפוש כתובות או רכיבים. לפרטים נוספים, אפשר לקרוא את המאמר פרמטרים של קידוד גיאוגרפי.
3 איך לשלוח בקשה לקידוד גיאוגרפי הפוך עליך לציין קואורדינטות של קווי אורך ורוחב יחד עם מפתח ה-API כדי לקבל רכיבי כתובת עבור הכתובת הקרובה ביותר שבן אדם יכול לקרוא. לפרטים נוספים, אפשר לעיין בבקשות הפוך לקידוד גיאוגרפי .
4 מידע בסיסי על תגובות כל נקודות הקצה ב-geocoding API יחזירו את אותם נתונים ב-JSON או ב-XML. בקטע תגובות גיאוגרפיות אפשר לקרוא הסבר על הנתונים, קודי הסטטוס והודעות השגיאה.
5 משלבים נתוני קידוד גיאוגרפי באפליקציה שלכם! ניתן להשתמש בנתוני קידוד גיאוגרפי כדי לקבל כתובות מסמני המפה או כדי לספק סמנים במפה על סמך כתובת ידועה.

ספריות לקוח זמינות

קראו ל-API בשפה הרצויה דרך אחת מספריות הלקוח:

לקוחות Java, Python Client, Go Client ו-Node.js עבור שירותי מפות Google הם ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח בהתאם לרישיון Apache 2.0. מורידים אותם מ-GitHub. שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

המאמרים הבאים