Method: geocode.location.geocodeLocationQuery

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

طلب HTTP

GET https://geocode.googleapis.com/v4beta/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 (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