Geocoding API v4 הוא שירות שמספק קידוד גאוגרפי, המרת קואורדינטות לכתובות (reverse geocoding) של כתובות ומזהי מקומות, ומידע על יעדים.
המרת כתובות לקואורדינטות (geocoding) הוא תהליך של המרת כתובות (כמו כתובת רחוב) לקואורדינטות גאוגרפיות (כמו קווי רוחב ואורך), שאפשר להשתמש בהן כדי להציב סמנים במפה או למקם את המפה.
המרת קואורדינטות לכתובות (reverse geocoding) היא תהליך של המרת קואורדינטות גאוגרפיות לכתובת שניתן לקרוא.
אפשר גם להשתמש ב-Geocoding API כדי למצוא את הכתובת של מזהה מקום נתון.
דוגמה לבקשה ולתגובה
הגישה אל Geocoding API מתבצעת דרך ממשק HTTP. בהמשך מופיעות דוגמאות לבקשות של המרת קואורדינטות לכתובות (geocoding) ושל המרת קואורדינטות לכתובות (reverse geocoding).
בקשה ותגובה של המרת כתובות לקואורדינטות (חיפוש של קו רוחב וקו אורך)
בדוגמה הבאה מוצגת בקשה לקבלת קווי הרוחב והאורך של הכתובת '1600 Amphitheatre Parkway, Mountain View, CA', ומוגדר שהפלט יהיה בפורמט JSON.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
כדי לבדוק את זה, מזינים את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל).
התשובה כוללת את קו הרוחב וקו האורך של הכתובת.
במדריך למפתחים אפשר לקרוא מידע נוסף על יצירת כתובות URL של בקשות להמרת כתובות לקואורדינטות (geocoding), על פרמטרים זמינים ועל הסבר על התגובה.
בהמשך מופיעה דוגמה לתגובה של המרת כתובות לקואורדינטות (geocoding) ב-JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
בקשה ותגובה של המרת קואורדינטות לכתובות (חיפוש כתובת)
בדוגמה הבאה מוצגת בקשה לקבלת הכתובת שמתאימה לקו רוחב ולקו אורך מסוימים בברוקלין, ניו יורק, ארה"ב. הוא מציין שהפלט צריך להיות בפורמט JSON.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYכדי לבדוק את זה, מזינים את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל). התשובה כוללת כתובת קריאה של המיקום לפי קו הרוחב וקו האורך.
מידע נוסף על יצירת כתובות URL של בקשות להמרת קואורדינטות לכתובות (reverse geocoding), על פרמטרים זמינים ועל הסבר על התגובה זמין במדריך למפתחים.
למטה מופיעה דוגמה לתגובה של המרת קואורדינטות לכתובות, בפורמט JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
אימות, מכסות, תמחור ומדיניות
אימות
כדי להשתמש ב-Geocoding API, קודם צריך להפעיל את ה-API ולקבל את פרטי האימות המתאימים. מידע נוסף זמין במאמר תחילת העבודה עם Google Maps Platform.
מכסות ותמחור
פרטים על המכסות והתמחור שנקבעו ל-Geocoding API מופיעים בדף שימוש וחיוב.
מדיניות
השימוש ב-Geocoding API צריך להיות בהתאם למדיניות ה-API.