تقديم طلب الترميز الجغرافي والرد عليه

تعرض لك هذه الصفحة الطلبات والردود لاسترداد عنوان معرّف مكان.

المعلمات المطلوبة

  • place_id : رقم تعريف المكان الذي تريد الحصول على العنوان الذي يمكن للمستخدم قراءته. رقم تعريف المكان هو معرّف فريد يمكن استخدامه مع واجهات Google API الأخرى. على سبيل المثال، يمكنك استخدام السمة placeID التي تعرضها واجهة برمجة التطبيقات للطرق للحصول على العنوان لنقطة سريعة. ولمزيد من المعلومات عن أرقام تعريف الأماكن، يُرجى الاطّلاع على نظرة عامة على أرقام تعريف الأماكن.
  • key: مفتاح واجهة برمجة التطبيقات الخاص بتطبيقك يحدِّد هذا المفتاح تطبيقك لأغراض إدارة الحصة. يمكنك الاطّلاع على كيفية الحصول على مفتاح.

المعلّمات الاختيارية هي نفسها المعلَمات في الترميز الجغرافي العكسي.

يحتوي طلب البحث التالي على رقم تعريف المكان في بروكلين:

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

للحصول على وصف للحقول في الرد، اطّلِع على استجابات الترميز الجغرافي.