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

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

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

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

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

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

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"
}

תיאור של השדות בתגובה זמין במאמר תשובות לגבי יצירת מפות.