Geocoding API הוא שירות שמספק המרה של כתובות לקואורדינטות (geocoding) והמרה של קואורדינטות לכתובות (reverse geocoding).
המרת כתובות לקואורדינטות (geocoding) היא תהליך של המרת כתובות (כמו כתובת רחוב) לקואורדינטות גיאוגרפיות (כמו קו רוחב וקו אורך), שבהן אפשר להשתמש כדי להציב סמנים במפה או למקם את המפה.
המרת קואורדינטות לכתובות (reverse geocoding) היא תהליך של המרת קואורדינטות גיאוגרפיות לכתובת שקריאה לאנשים.
אפשר גם להשתמש ב-Geocoding API כדי למצוא את הכתובת של מזהה מקום מסוים.
דוגמה לבקשה ולתשובה
הגישה ל-Geocoding API מתבצעת דרך ממשק HTTP. בהמשך מופיעות דוגמאות לבקשות של המרת כתובות לקואורדינטות (geocoding) ושל המרת קואורדינטות לכתובות (reverse geocoding).
בקשה ותגובה להמרת כתובות לקואורדינטות (חיפוש קווי אורך ורוחב)
בדוגמה הבאה מוצגת בקשה לקבלת קווי הרוחב והאורך של הכתובת 1600 Amphitheatre Parkway, Mountain View, CA, ומוגדר שהפלט יהיה בפורמט JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
כדי לבדוק את זה, מזינים את כתובת האתר בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל).
התשובה כוללת את קו הרוחב וקו האורך של הכתובת.
במדריך למפתחים אפשר לקבל מידע נוסף על יצירת כתובות URL של בקשות להמרת כתובות לקואורדינטות (geocoding), על פרמטרים זמינים ועל הסבר על התגובה.
בהמשך מוצגת דוגמה לתגובה של המרת כתובת לקואורדינטות, בפורמט JSON:
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
בקשה ותגובה של המרת קואורדינטות לכתובות (reverse geocoding) (חיפוש כתובת)
בדוגמה הבאה נשלחת בקשה לקבלת הכתובת שתואמת לקו הרוחב ולקו האורך שצוינו בברוקלין, ניו יורק, ארה"ב. הוא מציין שהפלט צריך להיות בפורמט JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYכדי לבדוק את זה, מזינים את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל). התשובה כוללת כתובת קריאה לאנשים, שמציינת את המיקום לפי קו הרוחב וקו האורך.
במדריך למפתחים יש מידע נוסף על יצירת כתובות URL לבקשות של המרת קואורדינטות לכתובות (reverse geocoding), על פרמטרים זמינים ועל הסבר על התגובה.
למטה מופיעה דוגמה לתגובה של המרת קואורדינטות לכתובות (reverse geocoding), בפורמט JSON:
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
מתחילים לתכנת באמצעות ספריות הלקוח שלנו
ספריות הלקוח עוזרות לכם לפתח באמצעות ממשקי ה-API של שירות האינטרנט של מפות Google, ומספקות הטמעות מובנות של משימות נפוצות, כמו אימות, הגבלת קצב הבקשות וניסיון חוזר אוטומטי. Geocoding API זמין ב-Java Client, Python Client, Go Client ו-Node.js Client לשירותי מפות Google.
אימות, מכסות, תמחור ומדיניות
אימות
כדי להשתמש ב-Geocoding API, קודם צריך להפעיל את ה-API ולקבל את פרטי הכניסה לאימות המתאימים. מידע נוסף זמין במאמר תחילת העבודה עם Google Maps Platform.
מכסות ותמחור
פרטים על המכסות והתמחור של Geocoding API זמינים בדף שימוש וחיוב.
מדיניות
השימוש ב-Geocoding API חייב להיות בהתאם למדיניות ה-API.
מידע נוסף
יש עוד דברים שאפשר לעשות עם Geocoding API. ב מדריך למפתחים של Geocoding API יש הדגמות נוספות, דוגמאות, פרמטרים זמינים, קודי סטטוס והודעות שגיאה ופרטים נוספים.
במדריך למפתחים של Geocoding API מתואר שירות האינטרנט של Geocoding API. הוא מיועד למפתחי אתרים ומובייל שרוצים להשתמש בנתוני המרת כתובות לקואורדינטות (geocoding) במפות שסופקו על ידי אחד מממשקי ה-API של Google Maps Platform.