Method: resolveNames

تحلّ هذه الدالة قائمة بأسماء الأماكن (أو العناوين) إلى كيانات جغرافية مكانية معيّنة (مثل الأماكن) على "خرائط Google".

طلب HTTP

POST https://mapstools.googleapis.com/v1:resolveNames

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
الحقول
queries[]

object (LocationQuery)

الحقل مطلوب. قائمة بطلبات البحث عن المواقع الجغرافية التي يجب حلّها يمكنك تحديد ما يصل إلى 20 طلب بحث.
locationBias

object (LocationBias)

اختيارية: منطقة اختيارية لتوجيه نتائج الحلّ في حال تحديد هذه السمة، ستكون نتائج الحلّ منحازة إلى الكيانات الأقرب إلى هذه المنطقة. يؤدي تضمين locationBias أو regionCode غالبًا إلى الحصول على نتائج أفضل من خلال تضييق نطاق البحث.

إذا تم تحديد كل من locationBias وregionCode، تكون الأولوية لـ locationBias على regionCode.
regionCode

string

اختيارية: رمز منطقة اختياري لتوجيه نتائج الحلّ في حال تحديد هذه السمة، ستكون نتائج الحلّ منحازة إلى الكيانات الموجودة في المنطقة المحدّدة أو بالقرب منها. يجب أن يكون هذا رمز منطقة CLDR. على سبيل المثال، "US" أو "CA". يؤدي تضمين locationBias أو regionCode غالبًا إلى الحصول على نتائج أفضل من خلال تضييق نطاق البحث.

إذا تم تحديد كل من locationBias وregionCode، تكون الأولوية لـ locationBias على regionCode.

نص الاستجابة

رسالة الردّ على v1.resolveNames

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
الحقول
results[]

object (Result)

للعرض فقط. قائمة الكيانات التي تم حلّها من طلبات البحث عن الموقع الجغرافي يضمن ذلك الربط بنسبة 1:1 مع فهارس الطلب queries. تشير السلسلة الفارغة في الفهرس i إلى تعذُّر التحويل لطلب البحث هذا. في حال تعذُّر إكمال عملية التحويل، يُرجى التحقّق من حقل failedRequests لمعرفة حالة الخطأ.
failedRequests

map (key: integer, value: object (Status))

للعرض فقط. خريطة توضّح حالات الفشل الجزئية المفتاح هو فهرس الطلب الذي تعذّر تنفيذه في الحقل queries. القيمة هي حالة الخطأ التي توضّح سبب تعذُّر إكمال عملية التحويل.

عنصر يحتوي على قائمة بأزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
saveToMapsUrl

string

للعرض فقط. رابط لحفظ جميع الكيانات التي تم حلّها بنجاح في "خرائط Google"

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/maps-platform.mapstools

LocationQuery

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

تمثيل JSON 
{
  "text": string
}
الحقول
text

string

الحقل مطلوب. يمثّل هذا الحقل طلب البحث النصي الذي يتم تحليله إلى كيان جغرافي مكاني محدّد على "خرائط Google"، مثل مكان أو عنوان. كلما كان طلب البحث أكثر تحديدًا، كان الحل أكثر دقة. على سبيل المثال، "القاهرة" أو "Googleplex, Mountain View, CA" أو "1600 Amphitheatre Parkway, Mountain View, CA" أو "برج إيفل، باريس". يجب أن تكون طلبات البحث عنوانًا أو اسم مكان محدّدًا. لا يمكن استخدام المواقع الجغرافية العامة، مثل اسم سلسلة متاجر (مثل Starbucks) أو طلب بحث مثل "مطاعم".

LocationBias

المنطقة التي يتم تحيز نتائج الحل إليها.

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
الحقول
نوع الانحياز للموقع الجغرافي في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
viewport

object (Viewport)

إطار عرض محدّد بمربّع محيط
نهاية الحقول التي يستبعد كلّ منها الآخر

النتيجة

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

تمثيل JSON 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
الحقول
entity

object (Entity)

للعرض فقط. تمثّل هذه السمة الكيان الذي تم حلّه من طلب البحث عن الموقع الجغرافي.
confidence

enum (Confidence)

للعرض فقط. مستوى الثقة في الحلّ

الثقة

مستوى الثقة في الحلّ

عمليات التعداد
CONFIDENCE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
MEDIUM تشير الثقة المتوسطة إلى أنّ الحلّ صحيح على الأرجح، ولكن قد تكون هناك حلول أخرى محتملة.
HIGH تشير الثقة العالية إلى أنّ الحلّ صحيح ويمثّل كيانًا جغرافيًا مكانيًا معيّنًا (مثل مكان معيّن).