Method: geocode.places.geocodePlace

تُجري هذه الطريقة عملية بحث عن ترميز جغرافي باستخدام رقم تعريف مكان.

طلب HTTP

GET https://geocode.googleapis.com/v4alpha/geocode/{place=places/*}

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

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

المعلمات
place

string

الحقل مطلوب. معرّف المكان المطلوب ترميزه جغرافيًا بالتنسيق places/{place}

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

المعلمات
languageCode

string

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

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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