Method: geocode.location.geocodeLocation

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

درخواست HTTP

GET https://geocode.googleapis.com/v4alpha/geocode/location

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
languageCode

string

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

regionCode

string

اختیاری. کد منطقه. کد منطقه، که به عنوان یک مقدار دو کاراکتری ccTLD ("دامنه سطح بالا") مشخص شده است. این پارامتر بر اساس قانون مربوطه بر نتایج تأثیر می‌گذارد.

types[]

string

اختیاری. مجموعه‌ای از برچسب‌های نوع برای محدود کردن نتایج. نتایجی که هیچ یک از انواع مشخص شده را نداشته باشند، حذف می‌شوند.

برای لیست کامل مقادیر ممکن، به جدول A و جدول B در آدرس https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

granularity[]

enum ( GeocodeResult.Granularity )

اختیاری. فیلتری از یک یا چند enum با جزئیات مکانی.

پارامتر union location_input . مکانی که قرار است location_input وارد شود، فقط می‌تواند یکی از موارد زیر باشد:
locationQuery

string

مکان در قالب رشته "lat,lng". برای مثال، "64.7611872,-18.4705364".

location

object ( LatLng )

مکان در قالب ساختاریافته.

درخواست بدنه

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

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از GeocodeLocationResponse است.

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

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

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