התחל בעבודה

Geocoding API הוא שירות שמספק המרת כתובות לקואורדינטות (geocoding) והמרת קואורדינטות לכתובות (reverse geocoding).

גאוקודינג הוא תהליך המרה של כתובות (כמו כתובת רחוב) לקואורדינטות גאוגרפיות (כמו קו הרוחב ואורך הגלובוס), שאפשר להשתמש בהן כדי להציב סמנים במפה או למקם את המפה.

המרת קואורדינטות לכתובות (reverse geocoding) היא תהליך המרה של קואורדינטות גאוגרפיות לכתובת שקריאה לבני אדם.

אפשר גם להשתמש ב-Geocoding API כדי למצוא את הכתובת של מזהה מקום נתון.

דוגמה לבקשה ולתגובה

הגישה ל-Geocoding API מתבצעת דרך ממשק HTTP. בהמשך מפורטות דוגמאות לבקשות של גיאוקודינג והמרת קואורדינטות לכתובות (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

כדי לבדוק זאת, מזינים את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את YOUR_API_KEY במפתח ה-API בפועל). התשובה כוללת את קו הרוחב ואת קו האורך של הכתובת.

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

בהמשך מוצגת תגובת גיאוקודינג לדוגמה, בפורמט 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"
}

בקשה ותגובה של המרת קואורדינטות לכתובות (חיפוש כתובת)

בדוגמה הבאה מופיעה בקשה לקבלת הכתובת התואמת לקו הרוחב/קו האורך שצוין בברוקלין, ניו יורק, ארה"ב. הוא מציין שהפלט חייב להיות בפורמט 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), בפורמט 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, בלקוח Python, בלקוח Go ובלקוח Node.js לשירותי מפות Google.

אימות, מכסות, תמחור ומדיניות

אימות

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

מכסות ותמחור

בדף שימוש וחיוב מפורטים פרטים על המכסות והתמחור של Geocoding API.

מדיניות

השימוש ב-Geocoding API חייב להתבצע בהתאם למדיניות ה-API.

מידע נוסף

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

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