Method: geocode.location.geocodeLocationQuery

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

طلب HTTP

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

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

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

المعلمات
الموقع الجغرافي المطلوب ترميزه جغرافيًا في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
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

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