شروع کنید

Geocoding API سرویسی است که geocoding و معکوس جغرافیایی آدرس ها را ارائه می دهد.

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

ژئوکدینگ معکوس فرآیند تبدیل مختصات جغرافیایی به یک آدرس قابل خواندن برای انسان است.

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

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

شما از طریق رابط HTTP به API Geocoding دسترسی دارید. در زیر نمونه هایی از درخواست های geocoding و معکوس جغرافیایی آورده شده است.

درخواست و پاسخ کدگذاری جغرافیایی (جستجوی طول و عرض جغرافیایی)

مثال زیر طول و عرض جغرافیایی "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

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

برای اطلاعات بیشتر درباره ساخت URL های درخواست کدگذاری جغرافیایی و پارامترهای موجود و درک پاسخ ، راهنمای توسعه دهنده را مشاهده کنید.

در زیر یک نمونه پاسخ کدگذاری جغرافیایی در 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

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

برای اطلاعات بیشتر در مورد ساخت URL های درخواست کدگذاری جغرافیایی معکوس و پارامترهای موجود و درک پاسخ ، راهنمای توسعه دهنده را مشاهده کنید.

در زیر یک نمونه پاسخ ژئوکدینگ معکوس در 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 را آسان‌تر می‌کنند. API Geocoding در 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 را توضیح می‌دهد. این برای توسعه دهندگان وب سایت و تلفن همراه است که می خواهند از داده های رمزگذاری جغرافیایی در نقشه های ارائه شده توسط یکی از API های پلتفرم Google Maps استفاده کنند.