Geocoding API v4 הוא שירות שמספק קידוד גאוגרפי, המרת קואורדינטות לכתובות (reverse 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 של בקשות לגיאו-קידוד, על פרמטרים זמינים ועל הסבר על התגובה.
למטה מופיעה דוגמה לתגובה של גיאו-קידוד ב-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 של בקשות לגיאו-קידוד הפוך, על פרמטרים זמינים ועל הסבר על התגובה זמין במדריך למפתחים.
למטה מופיעה דוגמה לתגובה של גיאו-קידוד הפוך, ב-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.
מכסות ותמחור
פרטים על המכסות והתמחור שנקבעו ל-Geocoding API מופיעים בדף שימוש וחיוב.
מדיניות
השימוש ב-Geocoding API חייב להיות בהתאם למדיניות ה-API.