تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

ميزة "الإكمال التلقائي لطلبات البحث" (القديمة)

المطوّرون في المنطقة الاقتصادية الأوروبية

ملاحظة: مكتبات من جهة الخادم ومن جهة العميل

تتوفّر Places API أيضًا مع عميل Java وعميل Python وعميل Go وعميل Node.js لخدمات "خرائط Google". تُستخدم واجهة برمجة التطبيقات Places API ومكتبات البرامج في تطبيقات الخادم.

إذا كنت بصدد إنشاء تطبيق من جهة العميل، يمكنك الاطّلاع على حزمة تطوير البرامج بالاستناد إلى المكان لنظام التشغيل Android (الجديدة) وحزمة تطوير البرامج بالاستناد إلى المكان لنظام التشغيل iOS (الجديدة) ومكتبة الأماكن في Maps JavaScript API.

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

طلبات Query Autocomplete (Legacy)

تُعدّ خدمة "الإكمال التلقائي لطلبات البحث" (الإصدار القديم) جزءًا من Places API (الإصدار القديم) وتشارك مفتاح واجهة برمجة التطبيقات والحصة مع Places API (الإصدار القديم).

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

طلب "الإكمال التلقائي لطلب البحث" (القديم) هو عنوان URL يستخدم HTTP بالشكل التالي:

https://maps.googleapis.com/maps/api/place/queryautocomplete/output?parameters

حيث قد تكون قيمة output إما json أو xml.

يجب توفير مَعلمات معيّنة لبدء طلب "الإكمال التلقائي لطلب البحث" (القديم). كما هو معتاد في عناوين URL، يتم الفصل بين جميع المَعلمات باستخدام رمز العطف اللاتيني (&). في ما يلي قائمة بالمَعلمات وقيمها المحتملة.

المعلمات المطلوبة

إدخال

سلسلة النص المطلوب البحث عنها ستعرض خدمة "الإكمال التلقائي للأماكن" المطابقات المرشحة استنادًا إلى هذه السلسلة وسترتّب النتائج استنادًا إلى مدى صلتها بالموضوع.

المعلمات الاختيارية

language

اللغة التي سيتم عرض النتائج بها
- اطّلِع على قائمة اللغات المتاحة. تعدّل Google اللغات المتاحة بشكل متكرر، لذا قد لا تكون هذه القائمة شاملة.
- في حال عدم توفير language، تحاول واجهة برمجة التطبيقات استخدام اللغة المفضّلة كما هو محدّد في العنوان Accept-Language.
- تبذل واجهة برمجة التطبيقات قصارى جهدها لتوفير عنوان شارع يمكن قراءته لكل من المستخدم والسكان المحليين. لتحقيق هذا الهدف، تعرض عناوين الشوارع باللغة المحلية، وتتم كتابتها بأحرف أبجدية أخرى يمكن للمستخدم قراءتها إذا لزم الأمر، مع مراعاة اللغة المفضّلة. ويتم عرض جميع العناوين الأخرى باللغة المفضّلة. يتم عرض جميع مكوّنات العنوان باللغة نفسها، والتي يتم اختيارها من المكوّن الأول.
- إذا لم يكن الاسم متاحًا باللغة المفضّلة، تستخدم واجهة برمجة التطبيقات أقرب نتيجة مطابقة.
- تؤثر اللغة المفضّلة بشكل بسيط في مجموعة النتائج التي تختار واجهة برمجة التطبيقات عرضها، وفي ترتيب عرضها. تفسّر أداة الترميز الجغرافي الاختصارات بشكل مختلف حسب اللغة، مثل اختصارات أنواع الشوارع أو المرادفات التي قد تكون صالحة في لغة واحدة ولكن ليس في لغة أخرى. على سبيل المثال، utca وtér هما مرادفان لكلمة "شارع" باللغة الهنغارية.
الموقع

تحدّد هذه السمة نقطة، كإحداثيات latitude,longitude، للبحث حولها. تستخدم خدمة "الأماكن" الموقع الجغرافي لتوجيه البحث نحو تفضيل عرض النتائج في المنطقة المحدّدة من خلال location وradius، وقد يستمر عرض النتائج خارج المنطقة المحدّدة.

يمكن إلغاء المَعلمة location إذا كان query يحتوي على موقع جغرافي صريح مثل Market in Barcelona. قد يؤثر استخدام علامات الاقتباس حول طلب البحث أيضًا في الأهمية الممنوحة لـ location وradius.
اقتطاع

موضع الحرف الأخير في عبارة الإدخال الذي تستخدمه الخدمة لمطابقة عبارات البحث المقترَحة. على سبيل المثال، إذا كان المُدخل هو Google والإزاحة هي 3، ستطابق الخدمة Goo. تتم مطابقة السلسلة التي يحدّدها الإزاحة مع الكلمة الأولى في عبارة الإدخال فقط. على سبيل المثال، إذا كانت عبارة الإدخال هي Google abc وكانت الإزاحة 3، ستحاول الخدمة المطابقة مع Goo abc. وفي حال عدم توفير إزاحة، ستستخدم الخدمة العبارة بأكملها. يجب ضبط الإزاحة بشكل عام على موضع علامة الإقحام النصية.
نطاق جغرافي

تحدّد المسافة (بالأمتار) التي يتم عرض نتائج الأماكن ضمنها. ويمكنك توجيه النتائج إلى دائرة محدّدة من خلال تمرير مَعلمتَي location وradius. يؤدي ذلك إلى توجيه خدمة "الأماكن" إلى تفضيل عرض النتائج ضمن تلك الدائرة، وقد يستمر عرض النتائج خارج المنطقة المحدّدة.

سيتم تلقائيًا تثبيت نصف القطر على قيمة قصوى بناءً على نوع البحث والمَعلمات الأخرى.
- الإكمال التلقائي: 50,000 متر
- Nearby Search:
  - مع keyword أو name: ‏50,000 متر
  - بدون keyword أو name
    - ما يصل إلى 50,000 متر، ويتم تعديلها ديناميكيًا استنادًا إلى كثافة المنطقة، بشكل مستقل عن المَعلمة rankby.
    - عند استخدام rankby=distance، لن يتم قبول مَعلمة نصف القطر، وسيؤدي ذلك إلى ظهور INVALID_REQUEST.
- ميزة "الإكمال التلقائي للبحث": 50,000 متر
- البحث النصي: 50,000 متر

أمثلة على ميزة "الإكمال التلقائي لطلب البحث" (الإصدار القديم)

عنوان URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

طلب البحث "بيتزا بالقرب من باريس"، مع نتائج باللغة الفرنسية:

عنوان URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &language=fr
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'

يُرجى العِلم أنّه عليك استبدال مفتاح واجهة برمجة التطبيقات في هذه الأمثلة بمفتاحك الخاص.

استجابة ميزة "الإكمال التلقائي للبحث" (القديمة)

يتم عرض ردود ميزة "الإكمال التلقائي للبحث" (القديمة) بالتنسيق الذي تشير إليه العلامة output ضمن مسار طلب عنوان URL. يتم عرض النتائج أدناه لطلب بحث يتضمّن المَعلمات التالية:

عنوان URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

JSON

{
  "predictions":
    [
      {
        "description": "pizza near Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris" },
            { "offset": 18, "value": "France" },
          ],
      },
      {
        "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Pari Chowk" },
            { "offset": 23, "value": "NRI City" },
            { "offset": 33, "value": "Omega II" },
            { "offset": 43, "value": "Noida" },
            { "offset": 50, "value": "Uttar Pradesh" },
            { "offset": 65, "value": "India" },
          ],
      },
      {
        "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 16 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Disneyland Park" },
            { "offset": 28, "value": "Disneyland Drive" },
            { "offset": 46, "value": "Anaheim" },
            { "offset": 55, "value": "CA" },
            { "offset": 59, "value": "USA" },
          ],
      },
      {
        "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 30 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" },
            { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" },
            { "offset": 83, "value": "Paris" },
            { "offset": 90, "value": "France" },
          ],
      },
      {
        "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris Beauvais Airport" },
            { "offset": 35, "value": "Route de l'Aéroport" },
            { "offset": 56, "value": "Tillé" },
            { "offset": 63, "value": "France" },
          ],
      },
    ],
  "status": "OK",
}

XML

      
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>pizza near Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>France</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Pari Chowk</value>
   <offset>11</offset>
  </term>
  <term>
   <value>NRI City</value>
   <offset>23</offset>
  </term>
  <term>
   <value>Omega II</value>
   <offset>33</offset>
  </term>
  <term>
   <value>Noida</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Uttar Pradesh</value>
   <offset>50</offset>
  </term>
  <term>
   <value>India</value>
   <offset>65</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Disneyland Park</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Disneyland Drive</value>
   <offset>28</offset>
  </term>
  <term>
   <value>Anaheim</value>
   <offset>46</offset>
  </term>
  <term>
   <value>CA</value>
   <offset>55</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>59</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>22</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>16</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Cathédrale Notre-Dame de Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Parvis Notre-Dame - place Jean-Paul-II</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>83</offset>
  </term>
  <term>
   <value>France</value>
   <offset>90</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>36</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>30</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris Beauvais Airport</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Route de l'Aéroport</value>
   <offset>35</offset>
  </term>
  <term>
   <value>Tillé</value>
   <offset>56</offset>
  </term>
  <term>
   <value>France</value>
   <offset>63</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>

عندما تعرض خدمة "الأماكن" نتائج JSON من عملية بحث، فإنّها تضعها ضمن مصفوفة predictions. حتى إذا لم تعرض الخدمة أي نتائج (مثلاً، إذا كان location بعيدًا)، ستعرض مصفوفة predictions فارغة. تتألف ردود XML من صفر أو أكثر من عناصر <prediction>.

PlacesQueryAutocompleteResponse

الحقل	مطلوب	النوع	الوصف
`predictions`	مطلوب	Array<PlaceAutocompletePrediction>	يحتوي على مصفوفة من عبارات البحث المقترَحة. يمكنك الاطّلاع على PlaceAutocompletePrediction لمزيد من المعلومات.
`status`	مطلوب	PlacesAutocompleteStatus	يحتوي على حالة الطلب، وقد يحتوي على معلومات تصحيح الأخطاء لمساعدتك في تتبُّع سبب تعذُّر الطلب. لمزيد من المعلومات، يُرجى الاطّلاع على PlacesAutocompleteStatus.
`error_message`	اختياري	سلسلة	عندما تعرض الخدمة رمز حالة غير `OK`، قد يكون هناك حقل `error_message` إضافي ضمن عنصر الاستجابة. يحتوي هذا الحقل على معلومات أكثر تفصيلاً عن الأسباب وراء رمز الحالة المحدّد. لا يتم عرض هذا الحقل دائمًا، ومحتواه عرضة للتغيير.
`info_messages`	اختياري	Array<string>	عندما تعرض الخدمة معلومات إضافية حول مواصفات الطلب، قد يكون هناك حقل `info_messages` إضافي ضمن عنصر الاستجابة. لا يتم عرض هذا الحقل إلا للطلبات الناجحة. وقد لا يتم عرضه دائمًا، كما أنّ محتواه عرضة للتغيير.

PlacesAutocompleteStatus

رموز الحالة التي تعرضها الخدمة

‫OK يشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تم بنجاح.
ZERO_RESULTS تشير إلى أنّ عملية البحث كانت ناجحة ولكن لم يتم عرض أي نتائج. قد يحدث ذلك إذا تم تمرير حدود البحث في موقع جغرافي بعيد.
INVALID_REQUEST يشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات غير صالح، ويعود ذلك بشكل عام إلى عدم توفّر المَعلمة input.
OVER_QUERY_LIMIT يشير إلى أي مما يلي:
- لقد تجاوزت الحد المسموح به لعدد الطلبات في الثانية (QPS).
- لم يتم تفعيل الفوترة في حسابك.
- تم تجاوز الرصيد الشهري البالغ 200 دولار أمريكي أو الحد الأقصى للاستخدام الذي فرضته بنفسك.
- لم تعُد طريقة الدفع المقدَّمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).
يمكنك الاطّلاع على الأسئلة الشائعة حول "خرائط Google" لمزيد من المعلومات حول كيفية حلّ هذا الخطأ.
REQUEST_DENIED يشير إلى رفض طلبك، وذلك بشكل عام بسبب:
- لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
- المَعلمة key غير صالحة.
‫UNKNOWN_ERROR تشير إلى حدوث خطأ غير معروف.

عندما تعرض خدمة "الأماكن" نتائج JSON من عملية بحث، تضعها ضمن مصفوفة predictions. حتى إذا لم تعرض الخدمة أي نتائج (مثلاً، إذا كان location بعيدًا)، ستعرض مصفوفة predictions فارغة. تتألف ردود XML من عنصر واحد أو أكثر من عناصر <prediction>.

PlaceAutocompletePrediction

الحقل	مطلوب	النوع	الوصف
`description`	مطلوب	سلسلة	تحتوي على الاسم الذي يمكن لشخص عادي قراءته للنتيجة المعروضة. بالنسبة إلى نتائج `establishment`، يكون هذا عادةً اسم النشاط التجاري. هذا المحتوى مخصّص للقراءة كما هو، لذا لا تحلّل العنوان المنسَّق برمجيًا.
`matched_substrings`	مطلوب	Array<PlaceAutocompleteMatchedSubstring>	قائمة بالسلاسل الفرعية التي تصف موقع العبارة التي تم إدخالها في نص نتيجة التوقّع، بحيث يمكن تمييز العبارة إذا أردت ذلك. يمكنك الاطّلاع على PlaceAutocompleteMatchedSubstring لمزيد من المعلومات.
`structured_formatting`	مطلوب	PlaceAutocompleteStructuredFormat	توفّر هذه السمة نصًا منسَّقًا مسبقًا يمكن عرضه في نتائج الإكمال التلقائي. هذا المحتوى مخصّص للقراءة كما هو، لذا لا تحلّل العنوان المنسَّق برمجيًا. يمكنك الاطّلاع على PlaceAutocompleteStructuredFormat لمزيد من المعلومات.
`terms`	مطلوب	صفيف<PlaceAutocompleteTerm>	يحتوي على مصفوفة من العبارات التي تحدّد كل قسم من الوصف الذي تم عرضه (عادةً ما ينتهي قسم من الوصف بفاصلة). يحتوي كل إدخال في المصفوفة على حقل `value` الذي يتضمّن نص العبارة، وحقل `offset` الذي يحدّد موضع بداية هذه العبارة في الوصف، ويتم قياسه بأحرف Unicode. لمزيد من المعلومات، يُرجى الاطّلاع على PlaceAutocompleteTerm.
`distance_meters`	اختياري	عدد صحيح	المسافة المستقيمة بالمتر من نقطة الانطلاق لا يتم عرض هذا الحقل إلا للطلبات التي يتم إجراؤها باستخدام `origin`.
`place_id`	اختياري	سلسلة	معرّف نصي يحدّد مكانًا بشكل فريد. لاسترداد معلومات عن المكان، أدخِل هذا المعرّف في حقل placeId لطلب بيانات من Places API. لمزيد من المعلومات حول أرقام تعريف الأماكن، يُرجى الاطّلاع على نظرة عامة حول أرقام تعريف الأماكن.
`reference`	اختياري	سلسلة	تم إيقاف `reference` نهائيًا. يُرجى الاطّلاع على place_id.
`types`	اختياري	Array<string>	يحتوي على مصفوفة من الأنواع التي تنطبق على هذا المكان. على سبيل المثال: `[ "political", "locality" ]` أو `[ "establishment", "geocode", "beauty_salon" ]`. يمكن أن تحتوي الصفيفة على قيم متعددة. مزيد من المعلومات حول أنواع الأماكن

PlaceAutocompleteMatchedSubstring

الحقل	مطلوب	النوع	الوصف
`length`	مطلوب	الرقم	طول السلسلة الفرعية المطابقة في نص نتيجة التوقّع
`offset`	مطلوب	الرقم	الموقع الجغرافي لبداية السلسلة الفرعية المطابقة في نص نتيجة التوقّع

PlaceAutocompleteStructuredFormat

الحقل	مطلوب	النوع	الوصف
`main_text`	مطلوب	سلسلة	يحتوي على النص الرئيسي للتوقّع، وهو عادةً اسم المكان.
`main_text_matched_substrings`	مطلوب	Array<PlaceAutocompleteMatchedSubstring>	تحتوي على مصفوفة بقيمة `offset` و`length`. تصف هذه العناصر موقع العبارة التي تم إدخالها في نص نتيجة التوقّع، بحيث يمكن تمييز العبارة إذا أردت ذلك. يمكنك الاطّلاع على PlaceAutocompleteMatchedSubstring لمزيد من المعلومات.
`secondary_text`	اختياري	سلسلة	يحتوي على النص الثانوي للتوقّع، وهو عادةً الموقع الجغرافي للمكان.
`secondary_text_matched_substrings`	اختياري	Array<PlaceAutocompleteMatchedSubstring>	تحتوي على مصفوفة بقيمة `offset` و`length`. تصف هذه العناصر موقع العبارة التي تم إدخالها في نص نتيجة التوقّع، بحيث يمكن تمييز العبارة إذا أردت ذلك. يمكنك الاطّلاع على PlaceAutocompleteMatchedSubstring لمزيد من المعلومات.

PlaceAutocompleteTerm

الحقل	مطلوب	النوع	الوصف
`offset`	مطلوب	الرقم	تحدّد موضع بدء هذا المصطلح في الوصف، ويتم قياسه بأحرف Unicode
`value`	مطلوب	سلسلة	نص المصطلح

ميزة "الإكمال التلقائي لطلبات البحث" (القديمة) تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

طلبات Query Autocomplete (Legacy)

المعلمات المطلوبة

إدخال

المعلمات الاختيارية

language

الموقع

اقتطاع

نطاق جغرافي

أمثلة على ميزة "الإكمال التلقائي لطلب البحث" (الإصدار القديم)

عنوان URL

curl

عنوان URL

curl

استجابة ميزة "الإكمال التلقائي للبحث" (القديمة)

عنوان URL

curl

JSON

XML

PlacesQueryAutocompleteResponse

predictions

status

error_message

info_messages

PlacesAutocompleteStatus

PlaceAutocompletePrediction

description

matched_substrings

structured_formatting

terms

distance_meters

place_id

reference

types

PlaceAutocompleteMatchedSubstring

length

offset

PlaceAutocompleteStructuredFormat

main_text

main_text_matched_substrings

secondary_text

secondary_text_matched_substrings

PlaceAutocompleteTerm

offset

value

ميزة "الإكمال التلقائي لطلبات البحث" (القديمة)

`predictions`

`status`

`error_message`

`info_messages`

`description`

`matched_substrings`

`structured_formatting`

`terms`

`distance_meters`

`place_id`

`reference`

`types`

`length`

`offset`

`main_text`

`main_text_matched_substrings`

`secondary_text`

`secondary_text_matched_substrings`

`offset`

`value`