Method: geocode.location.geocodeLocation

تنفّذ هذه الطريقة ترميزًا جغرافيًا للموقع الجغرافي، ما يؤدي إلى ربط LatLng بعنوان. وتوفّر أيضًا معلومات منظَّمة حول العنوان.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
languageCode

string

اختياريّ. اللغة التي يجب عرض النتائج بها
regionCode

string

اختياريّ. رمز المنطقة رمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.
types[]

string

اختياريّ. مجموعة من علامات النوع لحصر النتائج تتم إزالة النتائج التي لا تتضمّن أيًا من الأنواع المحدّدة.

للاطّلاع على القائمة الكاملة بالقيم المحتملة، يُرجى الرجوع إلى الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]

enum (GeocodeResult.Granularity)

اختياريّ. فلتر يتضمّن قيمة تعدادية واحدة أو أكثر لمستوى تفاصيل الموقع الجغرافي.
مَعلمة الاتحاد 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