البحث في الأماكن القريبة (الإصدار القديم)

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

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

طلبات البحث في الجوار (الإصدار القديم)

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

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

حيث يمكن أن تكون output أيًا من القيم التالية:

  • json (يُنصح به) يشير إلى الإخراج بتنسيق JavaScript Object Notation ‏ (JSON)
  • ‫xml يشير إلى أنّ الناتج بتنسيق XML

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

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

الموقع

النقطة التي يتم استرداد معلومات المكان حولها يجب تحديد هذه السمة على أنّها latitude,longitude.

نطاق جغرافي

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

سيتم تثبيت نصف القطر تلقائيًا على قيمة قصوى بناءً على نوع البحث والمَعلمات الأخرى.

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

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

كلمة رئيسية

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

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

في حال حذف هذه المَعلمة، لن يتم عرض الأماكن التي تكون فيها قيمة business_status هي CLOSED_TEMPORARILY أو CLOSED_PERMANENTLY.

language

اللغة التي سيتم عرض النتائج بها

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

maxprice

يؤدي ذلك إلى حصر النتائج بالأماكن التي تقع ضمن النطاق المحدّد فقط. تتراوح القيم الصالحة بين 0 (الأقل تكلفة) و4 (الأعلى تكلفة)، ضمنًا. سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى.

minprice

يؤدي ذلك إلى حصر النتائج بالأماكن التي تقع ضمن النطاق المحدّد فقط. تتراوح القيم الصالحة بين 0 (الأقل تكلفة) و4 (الأعلى تكلفة)، ضمنًا. سيختلف المبلغ الدقيق الذي تشير إليه قيمة معيّنة من منطقة إلى أخرى.

الاسم

هذا الرمز مكافئ للرمز keyword. يتم دمج القيم في هذا الحقل مع القيم في الحقل keyword ويتم تمريرها كجزء من سلسلة البحث نفسها.

opennow

تعرض هذه المَعلمة فقط الأماكن المفتوحة في وقت إرسال الطلب. لن يتم عرض الأماكن التي لا تحدّد ساعات العمل في قاعدة بيانات Google Places إذا قمت بتضمين هذه المعلمة في طلب البحث.

pagetoken

تعرض ما يصل إلى 20 نتيجة من عملية بحث تم إجراؤها سابقًا. يؤدي ضبط مَعلمة pagetoken إلى تنفيذ عملية بحث باستخدام المَعلمات نفسها التي تم استخدامها سابقًا، ويتم تجاهل جميع المَعلمات الأخرى غير pagetoken.

rankby

تحدّد هذه المَعلمة ترتيب عرض النتائج. القيم المحتمَلة هي:

  • ‫prominence (تلقائي) يرتّب هذا الخيار النتائج حسب أهميتها. سيفضّل الترتيب الأماكن البارزة ضمن النطاق الجغرافي المحدّد على الأماكن المجاورة التي تتطابق مع طلب البحث ولكنّها أقل بروزًا. يمكن أن تتأثر الشهرة بترتيب المكان في فهرس Google، والشهرة العالمية، وعوامل أخرى. عند تحديد مستوى البروز، تكون المَعلمة radius مطلوبة.
  • distance. يؤدي هذا الخيار إلى تحيز نتائج البحث بترتيب تصاعدي حسب المسافة من الموقع المحدد. عند تحديد السمة distance، يجب استخدام سمة واحدة أو أكثر من السمات keyword أو name أو type، ولا يُسمح باستخدام السمة radius.

النوع

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

  • type=hospital|pharmacy|doctor يصبح type=hospital
  • يتم تجاهل type=hospital,pharmacy,doctor بالكامل

اطّلِع على قائمة الأنواع المتوافقة.

ملاحظة: يمكن أن تؤدي إضافة كل من keyword وtype بالقيمة نفسها (keyword=cafe&type=cafe أو keyword=parking&type=parking) إلى ZERO_RESULTS.

مثال على بحث في الجوار (الإصدار القديم)

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522%2C151.1957362&radius=1500&type=restaurant&keyword=cruise&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?keyword=cruise
  &location=-33.8670522%2C151.1957362
  &radius=1500
  &type=restaurant
  &key=YOUR_API_KEY

ملاحظة: في هذا المثال، عليك استبدال key بمفتاح واجهة برمجة التطبيقات الخاص بك لكي يعمل الطلب في تطبيقك.

استجابات "البحث في الجوار (الإصدار القديم)"

يعرض المثال التالي استجابة البحث في الجوار (الإصدار القديم).

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8587323, "lng": 151.2100055 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85739847010727, "lng": 151.2112436298927 },
                "southwest":
                  { "lat": -33.86009812989271, "lng": 151.2085439701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet",
        "name": "Cruise Bar",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 608,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uECvJIZuXT-uLDYm4DPbrV7gXVPeplbTWUgcOJ6rnfc4bUYCEAwPU_AmXGIaj0PDhWPbmrjQC8hhuXRJQjnA1-iREGEn7I0ZneHg5OP1mDT7lYVpa1hUPoz7cn8iCGBN9MynjOPSUe-UooRrFw2XEXOLgRJ-uKr6tGQUp77CWVocpcoG",
              "width": 1080,
            },
          ],
        "place_id": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "plus_code":
          {
            "compound_code": "46R6+G2 The Rocks, New South Wales",
            "global_code": "4RRH46R6+G2",
          },
        "price_level": 2,
        "rating": 4,
        "reference": "ChIJi6C1MxquEmsR9-c-3O48ykI",
        "scope": "GOOGLE",
        "types":
          ["bar", "restaurant", "food", "point_of_interest", "establishment"],
        "user_ratings_total": 1269,
        "vicinity": "Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks",
      },
      {
        "business_status": "OPERATIONAL",
        "geometry":
          {
            "location": { "lat": -33.8675219, "lng": 151.2016502 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86614532010728, "lng": 151.2031259298927 },
                "southwest":
                  { "lat": -33.86884497989272, "lng": 151.2004262701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Sydney Harbour Dinner Cruises",
        "opening_hours": { "open_now": true },
        "photos":
          [
            {
              "height": 835,
              "html_attributions":
                [
                  'A Google User',
                ],
              "photo_reference": "Aap_uEBVsYnNcrpRixtrlHBztigZh70CwYkNWZzQnqJ39SjeBo_wvgKf-kXc6tgaMLBdQrRKmxmSKjOezoZrv-sHKVbTX0OI48HBqYYVnQiZQ-WGeuQDsLEPwX7LaVPa68nUAxX114Zpqt7bryoO9wL4qXdgEnopbOp5WWLALhKEHoIEH7f7",
              "width": 1200,
            },
          ],
        "place_id": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "plus_code":
          {
            "compound_code": "46J2+XM Sydney, New South Wales",
            "global_code": "4RRH46J2+XM",
          },
        "rating": 4.8,
        "reference": "ChIJM1mOVTS6EmsRKaDzrTsgids",
        "scope": "GOOGLE",
        "types":
          [
            "tourist_attraction",
            "travel_agency",
            "restaurant",
            "food",
            "point_of_interest",
            "establishment",
          ],
        "user_ratings_total": 9,
        "vicinity": "32 The Promenade, Sydney",
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Cruise Bar</name>
  <vicinity>Level 1, 2 and 3, Overseas Passenger Terminal, Circular Quay W, The Rocks</vicinity>
  <type>bar</type>
  <type>restaurant</type>
  <type>food</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8587323</lat>
    <lng>151.2100055</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8600981</lat>
     <lng>151.2085440</lng>
    </southwest>
    <northeast>
     <lat>-33.8573985</lat>
     <lng>151.2112436</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/bar-71.png</icon>
  <reference>ChIJi6C1MxquEmsR9-c-3O48ykI</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEALIq4sgBHhIYWWapOH2NV1T2I7YdOiLzEH7z-483I764cId1sZkbzSq-hVYTk1PQeaHuZzlRfA7-ilwJ3QWon4b37ePd-PBwZbOwFZHxhYs0Cs7jRSgMHWfOzGivp6ZFG4iupyz50qS5pBZT1WbA2ufacTq_U21TtgffQD31wKRPQk</photo_reference>
   <width>1080</width>
   <height>608</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112582655193348962755&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>2</price_level>
  <user_ratings_total>1269</user_ratings_total>
  <place_id>ChIJi6C1MxquEmsR9-c-3O48ykI</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46R6+G2</global_code>
   <compound_code>46R6+G2 The Rocks, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/bar_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Sydney Harbour Dinner Cruises</name>
  <vicinity>32 The Promenade, Sydney</vicinity>
  <type>tourist_attraction</type>
  <type>restaurant</type>
  <type>food</type>
  <type>travel_agency</type>
  <type>point_of_interest</type>
  <type>establishment</type>
  <geometry>
   <location>
    <lat>-33.8675219</lat>
    <lng>151.2016502</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8688450</lat>
     <lng>151.2004263</lng>
    </southwest>
    <northeast>
     <lat>-33.8661453</lat>
     <lng>151.2031259</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.8</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJM1mOVTS6EmsRKaDzrTsgids</reference>
  <opening_hours>
   <open_now>true</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEB5jH7GXdcozv1Y5HX18syo4f128S58NVUnqBbLJMpWbC39K49wp-wzsLOsUT8QKDaag6ISFL8hl1vVuig4jkc5fMMkWKiqw5PY-ebcWZ5tI3gEXEYGGoG_mDAulaMLudUpSwgBx2_RLnA0SSiugqqQUTYlkGyCZSe8HSyngVczy6XN</photo_reference>
   <width>1200</width>
   <height>835</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/109764923610545394994&quot;&gt;A Google User&lt;/a&gt;</html_attribution>
  </photo>
  <user_ratings_total>9</user_ratings_total>
  <place_id>ChIJM1mOVTS6EmsRKaDzrTsgids</place_id>
  <scope>GOOGLE</scope>
  <plus_code>
   <global_code>4RRH46J2+XM</global_code>
   <compound_code>46J2+XM Sydney, New South Wales</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
</PlaceSearchResponse>

PlacesNearbySearchResponse

الحقل مطلوب النوع الوصف
مطلوب Array<string>

قد يحتوي على مجموعة من السمات حول هذه البيانات التي يجب عرضها للمستخدم (قد لا تحتوي بعض البيانات على سمات).

مطلوب Array<Place>

يحتوي على مصفوفة من الأماكن.

تعرض طلبات "البحث عن الأماكن" مجموعة فرعية من الحقول التي تعرضها طلبات "تفاصيل المكان". إذا لم يعرض &quot;البحث عن الأماكن&quot; الحقل الذي تريده، يمكنك استخدام &quot;البحث عن الأماكن&quot; للحصول على place_id، ثم استخدام رقم تعريف المكان هذا لتقديم طلب &quot;تفاصيل المكان&quot;.

لمزيد من المعلومات، يُرجى الاطّلاع على المكان.
مطلوب PlacesSearchStatus

يحتوي على حالة الطلب، وقد يحتوي على معلومات تصحيح الأخطاء لمساعدتك في تتبُّع سبب تعذُّر الطلب.

يُرجى الاطّلاع على PlacesSearchStatus لمزيد من المعلومات.

اختياري سلسلة

عندما تعرض الخدمة رمز حالة غير OK<، قد يكون هناك حقل error_message إضافي ضمن عنصر الاستجابة. يحتوي هذا الحقل على معلومات أكثر تفصيلاً عن الأسباب وراء رمز الحالة المحدّد. لا يتم عرض هذا الحقل دائمًا، ومحتواه عرضة للتغيير.

اختياري Array<string>

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

next_page_token

اختياري سلسلة

يحتوي على رمز مميّز يمكن استخدامه لعرض ما يصل إلى 20 نتيجة إضافية. لن يتم عرض next_page_token إذا لم تكن هناك نتائج إضافية لعرضها. الحد الأقصى لعدد النتائج التي يمكن عرضها هو 60. هناك تأخير قصير بين وقت إصدار next_page_token ووقت تفعيله.

PlacesSearchStatus

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

  • ‫OK يشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات تم بنجاح.
  • ZERO_RESULTS يشير إلى أنّ عملية البحث كانت ناجحة ولكن لم يتم عرض أي نتائج. قد يحدث ذلك إذا تم تمرير latlng في موقع جغرافي بعيد إلى عملية البحث.
  • ‫INVALID_REQUEST تشير إلى أنّ طلب البيانات من واجهة برمجة التطبيقات مكتوب بشكلٍ غير صحيح، ويعود ذلك بشكل عام إلى عدم توفّر مَعلمة طلب البحث المطلوبة (location أو radius).
  • OVER_QUERY_LIMIT يشير إلى أيّ مما يلي:
    • لقد تجاوزت الحد الأقصى لعدد الطلبات في الثانية.
    • لم يتم تفعيل الفوترة في حسابك.
    • تم تجاوز الرصيد الشهري البالغ 200 دولار أمريكي أو الحد الأقصى للاستخدام الذي فرضته بنفسك.
    • لم تعُد طريقة الدفع المقدَّمة صالحة (على سبيل المثال، انتهت صلاحية بطاقة الائتمان).
    يمكنك الاطّلاع على الأسئلة الشائعة حول &quot;خرائط Google&quot; لمزيد من المعلومات حول كيفية حلّ هذا الخطأ.
  • REQUEST_DENIED يشير إلى أنّه تم رفض طلبك، وذلك عادةً بسبب:
    • لا يتضمّن الطلب مفتاح واجهة برمجة التطبيقات.
    • المَعلمة key غير صالحة.
  • ‫UNKNOWN_ERROR تشير إلى حدوث خطأ غير معروف.

المكان

تعرض ردود "البحث عن الأماكن" المجموعة الفرعية التالية من حقول المكان. لا تتوفّر بعض السمات لبعض أنواع الأماكن. لاسترداد الحقول التي لا تعرضها ميزة "البحث عن الأماكن"، مثل address_components أو formatted_phone_number أو reviews أو website، مرِّر place_id المعروض في طلب تفاصيل المكان (القديم). للاطّلاع على مدى توفّر الحقول وفئات الأسعار في جميع نقاط النهاية، يُرجى مراجعة حقول بيانات الأماكن (القديمة).

الحقل النوع الوصف
business_status string تشير إلى حالة عمل المكان، إذا كان نشاطًا تجاريًا: OPERATIONAL أو CLOSED_TEMPORARILY أو CLOSED_PERMANENTLY. يتم حذفها في حال عدم توفّر بيانات الحالة.
formatted_address string العنوان الذي يمكن لشخص عادي قراءته لهذا المكان يتم عرض هذا الحقل من خلال "البحث النصي (الإصدار القديم)" و"العثور على مكان (الإصدار القديم)". لا تحلّل العنوان المنسَّق برمجيًا، بل اطلب address_components في تفاصيل المكان (الإصدار القديم) بدلاً من ذلك.
geometry Geometry يحتوي على location المرمّز جغرافيًا مع إحداثيات lat وlng، وviewport المفضّل مع حدود northeast وsouthwest.
icon string عنوان URL لرمز مقترَح يمكنك عرضه عند الإشارة إلى هذه النتيجة على خريطة
icon_background_color string رمز اللون الست عشري التلقائي لفئة المكان
icon_mask_base_uri string الجزء الأساسي من عنوان URL لرمز مقترَح، بدون امتداد نوع الملف SVG أو PNG
name string الاسم الذي يمكن لشخص عادي قراءته للنتيجة المعروضة بالنسبة إلى نتائج establishment، تكون هذه القيمة عادةً اسم النشاط التجاري الذي تم تحديده كنسخة أساسية.
opening_hours PlaceOpeningHours معلومات ساعات العمل تعرض نقاط نهاية &quot;البحث عن الأماكن&quot; الحقل الفرعي المنطقي open_now فقط. يمكنك طلب opening_hours في &quot;تفاصيل المكان&quot; (الإصدار القديم) للحصول على periods وweekday_text.
permanently_closed boolean متوقّفة نهائيًا: استخدِم السمة business_status للتحقّق من حالة التشغيل لنشاط تجاري.
photos Array<PlacePhoto> تمثّل هذه السمة مصفوفة من عناصر PlacePhoto، ويحتوي كل عنصر على photo_reference وheight وwidth وhtml_attributions. للاطّلاع على تفاصيل الاستخدام، يُرجى مراجعة صور الأماكن (الإصدار القديم).
place_id string معرّف نصي يحدّد مكانًا بشكل فريد مرِّر رقم التعريف هذا في المَعلمة place_id لطلب تفاصيل المكان (القديم). اطّلِع على نظرة عامة على رقم تعريف المكان.
plus_code PlusCode مرجع موقع جغرافي مرمّز مشتق من إحداثيات خطوط العرض والطول، ويحتوي على global_code وcompound_code اختياري.
price_level integer مستوى سعر المكان على مقياس من 0 إلى 4، من الأقل تكلفة إلى الأعلى تكلفة يمكنك الاطّلاع على price_level.
rating number يشير هذا الحقل إلى تقييم المكان، من 1.0 إلى 5.0، استنادًا إلى مراجعات المستخدمين المجمّعة.
reference string تم إيقافها نهائيًا: يُرجى استخدام place_id بدلاً منها.
scope string متوقّفة نهائيًا: تشير إلى نطاق place_id، وهو دائمًا GOOGLE. يتم عرضها من خلال "بحث في الجوار (الإصدار القديم)".
types Array<string> مصفوفة من أنواع الميزات التي تصف النتيجة المحدّدة راجِع أنواع الأماكن (القديمة).
user_ratings_total integer تمثّل هذه السمة إجمالي عدد التقييمات لهذا المكان، سواء كانت تتضمّن نص مراجعة أم لا.
vicinity string عنوان مبسّط للمكان، بما في ذلك اسم الشارع ورقم الشارع والمنطقة، بدون الولاية أو المقاطعة أو الرمز البريدي أو البلد يتم عرضها من خلال خدمة "بحث في الجوار (الإصدار القديم)".

الوصول إلى النتائج الإضافية

بشكل تلقائي، يعرض كل ردّ ما يصل إلى 20 نتيجة establishment لكل طلب بحث، ولكن يمكن أن يعرض كل بحث ما يصل إلى 60 نتيجة مقسّمة على ثلاث صفحات. إذا كان البحث سيعرض أكثر من 20 نتيجة، سيتضمّن ردّ البحث قيمة إضافية، وهي next_page_token. مرِّر قيمة next_page_token إلى مَعلمة pagetoken لطلب جديد للاطّلاع على المجموعة التالية من النتائج.

  • إذا كانت قيمة next_page_token فارغة أو لم يتم عرضها، يعني ذلك أنّه ما مِن نتائج أخرى.
  • وستؤدي إعادة محاولة إرسال الطلب باستخدام قيمة next_page_token نفسها إلى عرض الصفحة التالية من النتائج.
  • سيؤدي ضبط pagetoken إلى تجاهل أي مَعلمات أخرى.
  • يمكنك طلب صفحة جديدة مرتين كحد أقصى بعد طلب البحث الأصلي.
  • يتم احتساب كل طلب، بما في ذلك الطلب الذي يستخدم next_page_token، كطلب واحد ضمن حدود الاستخدام ويتم تحصيل رسوم منفصلة عنه.
  • هناك تأخير لبضع ثوانٍ بين وقت إصدار next_page_token ووقت تفعيله. سيؤدي طلب الصفحة التالية قبل توفّرها إلى عرض استجابة INVALID_REQUEST. يتم دائمًا تحصيل رسوم مقابل الطلبات التي تتضمّن المَعلمة next_page_token.

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

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

للاطّلاع على المجموعة التالية من النتائج، يمكنك إرسال طلب بحث جديد، مع تمرير نتيجة next_page_token إلى المَعلمة pagetoken. على سبيل المثال: 

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY