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، ماونتن فيو، كاليفورنيا" أو "1600 Amphitheatre Parkway، ماونتن فيو، كاليفورنيا" أو "برج إيفل، باريس". يجب أن تكون طلبات البحث عبارة عن عنوان أو اسم مكان محدّد. لا تتوفّر المواقع الجغرافية العامة، مثل اسم سلسلة متاجر (مثل "ستاربكس") أو طلب بحث مثل "مطاعم".

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 يشير مستوى الموثوقية العالي إلى أنّ درجة الدقة صحيحة وتمثّل كيانًا جغرافيًا مكانيًا محدّدًا (مثل مكان محدّد).