Method: geocode.location.geocodeLocationQuery

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

طلب HTTP

GET https://geocode.googleapis.com/v4/geocode/location/{locationQuery}

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

مَعلمات المسار

المعلمات
مَعلمة الربط location_input الموقع المطلوب ترميزه جغرافيًا. يمكن أن يكون التعليق location_input إحدى القيم التالية فقط:
locationQuery

string

الموقع الجغرافي بالتنسيق "lat,lng" (خط العرض، خط الطول). على سبيل المثال، "64.7611872,-18.4705364".

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

المعلمات
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 إحدى القيم التالية فقط:
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