Method: geocode.address.geocodeAddressQuery

این روش زمین‌کدیابی نشانی را انجام می‌دهد که نشانی را به LatLng نگاشت می‌کند. همچنین اطلاعات ساختاریافته‌ای درباره نشانی ارائه می‌دهد.

درخواست HTTP

GET https://geocode.googleapis.com/v4/geocode/address/{addressQuery}

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
نشانی برای زمین‌کدیابی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
addressQuery

string

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

پارامترهای پُرسمان

پارامترها
locationBias

object (GeocodeAddressRequest.LocationBias)

اختیاری. منطقه موردنظر برای جستجو. این مکان به‌عنوان سوگیری عمل می‌کند، یعنی نتایج اطراف مکان ارائه‌شده ترجیح داده می‌شود.
languageCode

string

اختیاری. زبان نتایجی که باید برگردانده شود.
regionCode

string

اختیاری. کد منطقه. کد منطقه، که به‌عنوان مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») مشخص شده است. این پارامتر براساس قانون ذی‌ربط بر نتایج تأثیر می‌گذارد. این پارامتر همچنین بر نتایج سرویس تأثیر می‌گذارد، اما آن‌ها را کاملاً محدود نمی‌کند.
نشانی برای زمین‌کدیابی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
address

object (PostalAddress)

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

متن درخواست

بدنه درخواست باید خالی باشد.

بدنه پاسخ

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی نمونه‌ای از GeocodeAddressResponse است.

دامنه‌های مجوز

به یکی از دامنه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address