درخواست و پاسخ برای کدگذاری جغرافیایی

این صفحه درخواست ها و پاسخ هایی را برای بازیابی آدرس برای شناسه مکان به شما نشان می دهد.

پارامترهای مورد نیاز

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

برای توضیح فیلدهای موجود در پاسخ، به پاسخ‌های کدگذاری جغرافیایی مراجعه کنید.