Geocoding API v4 הוא שירות שמספק המרת כתובות לקואורדינטות (geocoding), המרת קואורדינטות לכתובות (reverse geocoding) של כתובות ומזהי מקומות, ומידע על יעדים.
המרת כתובות לקואורדינטות (geocoding) היא תהליך של המרת כתובות (כמו כתובת רחוב) לקואורדינטות גיאוגרפיות (כמו קו רוחב וקו אורך), שבהן אפשר להשתמש כדי להציב סמנים במפה או למקם את המפה.
המרת קואורדינטות לכתובות (reverse geocoding) היא תהליך של המרת קואורדינטות גיאוגרפיות לכתובת שקריאה למשתמשים.
אתם יכולים גם להשתמש ב-Geocoding API כדי למצוא את הכתובת של מזהה מקום מסוים, ולאחזר מידע מפורט על יעדים שונים באמצעות השיטה SearchDestinations.
דוגמה לבקשה ולתשובה
הגישה ל-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/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
כדי לבדוק את זה, אפשר להזין את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל).
התשובה כוללת את קו הרוחב וקו האורך של הכתובת.
במדריך למפתחים אפשר לקרוא מידע נוסף על יצירת כתובות URL של בקשות להמרת כתובות לקואורדינטות (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" ] } ] }
בקשה ותגובה של המרת קואורדינטות לכתובות (reverse geocoding) (חיפוש כתובת)
בדוגמה הבאה מוצגת בקשה לקבלת הכתובת שמתאימה לקו רוחב/קו אורך מסוימים בברוקלין, ניו יורק, ארה"ב. הוא מציין שהפלט חייב להיות בפורמט JSON.
https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYכדי לבדוק את זה, מזינים את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל). התשובה כוללת כתובת קריאה לאנשים של מיקום קו הרוחב וקו האורך.
מידע נוסף על יצירת כתובות URL של בקשות להמרת קואורדינטות לכתובות (reverse geocoding), על פרמטרים זמינים ועל הסבר על התגובה זמין במדריך למפתחים.
למטה מופיעה דוגמה לתגובה של המרת קואורדינטות לכתובות (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.