هذا المنتج أو هذه الميزة في حالة "قديم". لمزيد من المعلومات عن الحالة "قديمة"، يُرجى الاطّلاع على المنتجات والميزات القديمة. لنقل البيانات إلى Places API (الإصدار الجديد)، يُرجى الاطّلاع على دليل نقل البيانات.
تتيح لك Places API البحث عن معلومات الأماكن
باستخدام مجموعة متنوعة من الفئات، بما في ذلك المؤسسات ونقاط ملفتة للاهتمام
والمواقع الجغرافية. يمكنك البحث عن الأماكن إما عن طريق
قربها أو باستخدام سلسلة نصية. يعرض "بحث عن مكان" قائمة بالأماكن بالإضافة إلى
معلومات موجزة عن كل مكان، وتتوفّر معلومات إضافية باستخدام
طلب بحث تفاصيل المكان (قديم).
مقارنة أنواع البحث
تتوفّر ثلاث نقاط نهاية للبحث بخصائص مختلفة. يوضّح الجدول التالي
بعض هذه الاختلافات.
لا تتوفّر طريقة لتقييد "البحث عن المنتجات بالقرب منك" (الإصدار القديم) أو "البحث النصي" (الإصدار القديم) لعرض حقول معيّنة فقط. لتجنُّب طلب بيانات لا تحتاج إليها (ودفع رسومها)، استخدِم طلب "العثور على مكان" (القديم) بدلاً من ذلك.
نصّ غير واضح
تم تحسين ميزتَي "العثور على مكان" (القديمة) و"البحث النصي" (القديمة) لمطابقة النصوص المُبهمة في عدد من الحقول،
في حين أنّ ميزة "البحث عن الأماكن المجاورة" (القديمة) تقتصر على المطابقات الصارمة في مجموعة فرعية من الحقول.
فلاتر إضافية
تتيح ميزة "البحث عن الأماكن القريبة" (الإصدار القديم) وميزة "البحث النصي" (الإصدار القديم) استخدام مَعلمات إضافية لفلترة النتائج،
(مثل minprice وmaxprice وopennow وtype).
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Place Search\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n**Note: Server-side\nand client-side libraries**\n\nThe Places API is also available with the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/places/web-service/client-library).\nThe Places API and the client libraries are for\nuse in server applications.\n\nIf you're building a client-side\napplication, take a look at the\n[Places SDK for Android (New)](/maps/documentation/places/android-sdk), the\n[Places SDK for iOS (New)](/maps/documentation/places/ios-sdk), and the\n[Places Library, Maps JavaScript API](/maps/documentation/javascript/places).\n\nThe Places API lets you search for place information\nusing a variety of categories, including establishments, prominent points of\ninterest, and geographic locations. You can search for places either by\nproximity or a text string. A Place Search returns a list of places along with\nsummary information about each place; additional information is available using\na [Place Details (Legacy)](/maps/documentation/places/web-service/details) query.\n\nCompare search types\n--------------------\n\nThere are three search endpoints available with different characteristics. The following table\nhighlights some of these differences.\n\n| Type | [Field selection](#field-selection) | Text Search (Legacy) | [Ambiguous text](#ambiguous-text) | Location filter | [Additional filters](#additional-filters) |\n|----------------------------------------------------------------------------------------|-------------------------------------|----------------------|-----------------------------------|-----------------|-------------------------------------------|\n| [Find Place (Legacy)](/maps/documentation/places/web-service/legacy/search-find-place) | | `input` | | | |\n| [Nearby Search (Legacy)](/maps/documentation/places/web-service/legacy/search-nearby) | | `keyword` | | | |\n| [Text Search (Legacy)](/maps/documentation/places/web-service/legacy/search-text) | | `query` | | | |\n\n### Field selection\n\nThere is no way to constrain Nearby Search (Legacy) or Text Search (Legacy) to only return specific fields. To\nkeep from requesting (and paying for) data that you don't need, use a Find Place (Legacy) request instead.\n\n### Ambiguous text\n\nFind Place (Legacy) and Text Search (Legacy) are optimized for matching ambiguous text across a number of fields\nwhile Nearby Search (Legacy) is constrained to strict matches on a subset of fields.\n\n### Additional filters\n\nNearby Search (Legacy) and Text Search (Legacy) allow additional parameters to filter results,\n(e.g. `minprice`, `maxprice`, `opennow`, and `type`)."]]
