درخواست و پاسخ زمین‌کدیابی مکان

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

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

پارامترهای الزامی

  • place_id — شناسه مکان مکانی که می‌خواهید نشانی قابل‌خواندن برای انسان آن را دریافت کنید. شناسه مکان شناسه یکتایی است که می‌توان از آن با دیگر میاناهای برنامه‌سازی کاربردی Google استفاده کرد. برای مثال، می‌توانید از placeID برگردانده‌شده توسط Roads API برای دریافت نشانی نقطه چسبیده استفاده کنید. برای اطلاعات بیشتر درباره شناسه مکان، نمای کلی شناسه مکان را ببینید.
  • 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"
}

برای شرح فیلدهای موجود در پاسخ، به پاسخ‌های زمین‌کدیابی مراجعه کنید.