شروع به کار با Geocoding API v3

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

‫Geocoding API سرویسی است که زمین‌کدیابی و زمین‌کدیابی معکوس نشانی‌ها را ارائه می‌دهد.

زمین‌کدگذاری فرایند تبدیل نشانی‌ها (مثل نشانی خیابان) به مختصات جغرافیایی (مثل عرض و طول جغرافیایی) است که می‌توانید از آن برای قرار دادن نشانگرها روی نقشه یا موقعیت‌یابی نقشه استفاده کنید.

زمین‌کدیابی معکوس فرایند تبدیل مختصات جغرافیایی به نشانی قابل‌خواندن برای انسان است.

همچنین می‌توانید از Geocoding API برای پیدا کردن نشانی شناسه مکان معین استفاده کنید.

درخواست و پاسخ نمونه

ازطریق میانای HTTP به Geocoding API دسترسی پیدا می‌کنید. در زیر نمونه‌هایی از درخواست‌های زمین‌کدیابی و زمین‌کدیابی معکوس آورده شده است.

درخواست و پاسخ زمین‌کدیابی (جستجوی طول/عرض جغرافیایی)

مثال زیر طول و عرض جغرافیایی «1600 Amphitheatre Parkway, Mountain View, CA» را درخواست می‌کند و مشخص می‌کند که برونداد باید در قالب JSON باشد.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

می‌توانید این را با وارد کردن نشانی وب در مرورگر وب خود آزمایش کنید (حتماً YOUR_API_KEY را با کلید میانای برنامه‌سازی کاربردی واقعی خود جایگزین کنید). پاسخ شامل طول و عرض جغرافیایی نشانی است.

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

در زیر نمونه‌ای از پاسخ زمین‌کدیابی در قالب JSON آمده است:

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Parkway",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4267861,
               "lng" : -122.0806032
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4281350802915,
                  "lng" : -122.0792542197085
               },
               "southwest" : {
                  "lat" : 37.4254371197085,
                  "lng" : -122.0819521802915
               }
            }
         },
         "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE",
         "plus_code" : {
            "compound_code" : "CWC8+R3 Mountain View, California, United States",
            "global_code" : "849VCWC8+R3"
         },
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

درخواست و پاسخ زمین‌کدیابی معکوس (جستجوی نشانی)

مثال زیر نشانی مربوط به طول/عرض جغرافیایی داده‌شده در بروکلین، نیویورک، ایالات متحده را درخواست می‌کند. مشخص می‌کند که برونداد باید در قالب JSON باشد.

https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEY

می‌توانید این را با وارد کردن نشانی وب در مرورگر وب خود آزمایش کنید (حتماً «YOUR_API_KEY» را با کلید API واقعی خود جایگزین کنید). پاسخ شامل نشانی قابل‌خواندن برای انسان برای مکان طول و عرض جغرافیایی است.

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

در زیر نمونه‌ای از پاسخ زمین‌کدیابی معکوس در قالب JSON آمده است:

{
   "plus_code" : {
      "compound_code" : "P27Q+MC New York, NY, USA",
      "global_code" : "87G8P27Q+MC"
   },
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "279",
               "short_name" : "279",
               "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" : "279 Bedford Ave, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.7142484,
               "lng" : -73.9614103
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.71559738029149,
                  "lng" : -73.9600613197085
               },
               "southwest" : {
                  "lat" : 40.71289941970849,
                  "lng" : -73.96275928029151
               }
            }
         },
         "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE",
         "plus_code" : {
            "compound_code" : "P27Q+MC Brooklyn, New York, United States",
            "global_code" : "87G8P27Q+MC"
         },
         "types" : [
            "bakery",
            "cafe",
            "establishment",
            "food",
            "point_of_interest",
            "store"
         ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

با کتابخانه‌های مشتری ما کدنویسی را شروع کنید

کتابخانه‌های کارخواه با ارائه پیاده‌سازی‌های داخلی برای کارهای رایج، مانند اصالت‌سنجی، محدود کردن درخواست، و تلاش مجدد خودکار، به شما کمک می‌کنند با میاناهای برنامه‌سازی کاربردی سرویس وب Google Maps توسعه دهید. ‫Geocoding API در Java Client، Python Client،‏ Go Client، و Node.js Client برای «سرویس‌های Google Maps» دردسترس است.

اصالت‌سنجی، سهمیه، قیمت‌گذاری، و خط‌مشی‌ها

اصالت‌سنجی

برای استفاده از Geocoding API، ابتدا باید API را فعال کنید و اعتبارنامه‌های اصالت‌سنجی مناسب را دریافت کنید. برای اطلاعات بیشتر، به شروع به کار با Google Maps Platform مراجعه کنید.

سهمیه‌ها و قیمت‌گذاری

برای جزئیات مربوط به سهمیه‌ها و قیمت‌گذاری تنظیم‌شده برای Geocoding API، به صفحه استفاده و صورت‌حساب مراجعه کنید.

خط‌مشی‌ها

استفاده از Geocoding API باید مطابق با خط‌مشی‌های API باشد.

بیشتر بدانید

کارهای بیشتری می‌توانید با Geocoding API انجام دهید. برای دیدن نمایش‌های بیشتر، نمونه‌ها، پارامترهای دردسترس، کدهای وضعیت، پیام‌های خطا، و جزئیات دیگر، راهنمای توسعه‌دهنده Geocoding API را ببینید.

راهنمای توسعه‌دهندگان Geocoding API سرویس وب Geocoding API را شرح می‌دهد. این آموزش برای توسعه‌دهندگان وب‌سایت و تلفن همراهی درنظر گرفته شده است که می‌خواهند از داده‌های زمین‌کدی در نقشه‌های ارائه‌شده توسط یکی از میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» استفاده کنند.