שליחת בקשה לתגובה גיאוגרפית ותשובה

בדף הזה מוצגות בקשות ותשובות לאחזור כתובת עבור מזהה מקום.

פרמטרים נדרשים

• place_id — מזהה המקום של המקום שעבורו רוצים לקבל את הכתובת שקריאה לאנשים. מזהה המקום הוא מזהה ייחודי שאפשר להשתמש בו בממשקי API אחרים של Google. לדוגמה, אפשר להשתמש ב-placeID שהוחזר על ידי Roads API כדי לקבל את הכתובת של נקודה מוצמדת. מידע נוסף על מזהי מקומות זמין במאמר סקירה כללית על מזהי מקומות.
• key – מפתח ה-API של האפליקציה שלך. המפתח הזה מזהה את האפליקציה שלכם למטרות ניהול מכסות. איך מקבלים מפתח

הפרמטרים האופציונליים זהים לפרמטרים של המרת קידוד גיאוגרפי.

השאילתה הבאה מכילה את מזהה המקום של מקום בתל אביב:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJd8BlQ2BZwokRAFUEcm_qrcA
&key=YOUR_API_KEY

השאילתה שלמעלה מחזירה את התוצאה הבאה:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "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" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.7142205,
               "lng" : -73.9612903
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.71556948029149,
                  "lng" : -73.95994131970849
               },
               "southwest" : {
                  "lat" : 40.7128715197085,
                  "lng" : -73.9626392802915
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

לתיאור של השדות בתשובה, ראו קידוד גיאוגרפי של תשובות.