Method: geocode.address.geocodeAddress

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

طلب HTTP

GET https://geocode.googleapis.com/v4beta/geocode/address

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

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

المعلمات
locationBias

object (GeocodeAddressRequest.LocationBias)

اختياريّ. تمثّل هذه السمة المنطقة المطلوب البحث فيها. يعمل هذا الموقع الجغرافي كعامل ترجيح، ما يعني أنّ النتائج حول الموقع الجغرافي المحدّد لها الأولوية.
languageCode

string

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

string

اختياريّ. رمز المنطقة رمز المنطقة، ويتم تحديده كقيمة من حرفين ccTLD ("نطاق المستوى الأعلى"). تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري. ستؤثّر هذه المَعلمة أيضًا في النتائج من الخدمة، ولكنّها لن تقيّدها بالكامل.
مَعلمة الربط address_input تمثّل هذه السمة العنوان المطلوب ترميزه جغرافيًا. يمكن أن يكون التعليق address_input إحدى القيم التالية فقط:
addressQuery

string

العنوان غير المنظَّم المطلوب ترميزه جغرافيًا
address

object (PostalAddress)

العنوان المنظَّم المطلوب تحويله إلى إحداثيات جغرافية بتنسيق العنوان البريدي

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال GeocodeAddressResponse.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address