Method: geocode.location.geocodeLocation

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

درخواست HTTP

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

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

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

پارامترها
languageCode

string

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

string

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

string

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

برای مشاهده فهرست کامل مقادیر ممکن، به «جدول الف» و «جدول ب» در https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.
granularity[]

enum (GeocodeResult.Granularity)

اختیاری. فیلتری از یک یا چند شمارش دانه‌بندی مکان.
مکان برای زمین‌کدیابی. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
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