Places UI Kit
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
iOS
JavaScript
تتيح لك مكتبة مكونات Places UI Kit توفير تجربة المستخدم المألوفة في "خرائط Google" للأماكن في تطبيقاتك وصفحات الويب، وذلك باستخدام البيانات نفسها التي تستند إليها Places API. تتضمّن هذه المكتبة مجموعة من مكوّنات واجهة المستخدم الفردية التي يمكن استخدامها بشكل مستقل أو معًا أو بالتزامن مع واجهات برمجة تطبيقات أخرى في "منصة خرائط Google" لتقديم تجربة غنية بالأماكن بأقل تكلفة وأقل قدر من الرموز البرمجية.
تتضمّن Places UI Kit عناصر HTML التالية لعرض بيانات "أماكن Google":
تعرض
عناصر "تفاصيل المكان"
(تفاصيل المكان و"تفاصيل المكان" المضغوطة) تفاصيل، مثل ساعات العمل والموقع الإلكتروني والمراجعات الخاصة بمكان محدّد.
تعرض عناصر البحث عن الأماكن
(البحث عن الأماكن القريبة والبحث النصي عن الأماكن) قائمة بالأماكن استجابةً لطلب بحث
عن الأماكن القريبة أو طلب بحث نصي.
يعرض
عنصر الإكمال التلقائي الأساسي الخاص بالأماكن حقل إدخال نصي، ويوفّر توقعات خاصة بالأماكن في قائمة اختيار ضمن واجهة المستخدم، ويعرض رقم تعريف المكان المحدّد.
تعرض الارتفاع (تجريبية) بيانات الارتفاع كقيمة رقمية لنقطة واحدة، أو كمخطط مرئي لمسار.
الميزات والإمكانات الرئيسية
- يمكنك دمج تجربة Google الموثوقة بدءًا من الحد الأدنى من الرموز البرمجية.
- يمكنك دمج واجهة مستخدم "خرائط Google" الخاصة بـ "الأماكن" في تطبيقاتك بتكلفة أقل من واجهة Places API.
- اختَر خيارات البيانات والعرض التي تناسب احتياجاتك بشكل أفضل.
الفوترة
تتم دائمًا فوترة طلبات Places UI Kit وفقًا
لسعر واجهة برمجة التطبيقات Places UI Kit، بغض النظر عن طريقة البحث المستخدَمة أو أنواع البيانات التي يتم عرضها. على سبيل المثال، لن تتكبّد أي رسوم إضافية مقابل استخدام Places API Nearby Search Pro عند استخدام Places UI Kit Nearby Search. وبالمثل، قد يعرض طلب تفاصيل المكان في Places UI Kit صورًا وسعرًا وتقييمًا لمكان محدّد، ولكن لن يتم تحصيل رسوم منك إلا مقابل طلب تفاصيل المكان في Places UI Kit.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Places UI Kit offers pre-built UI components for integrating Google Maps Places functionality into your apps and web pages.\u003c/p\u003e\n"],["\u003cp\u003eIt includes components like Place Details, Place List, and Elevation for displaying place information and elevation data.\u003c/p\u003e\n"],["\u003cp\u003eThis kit is cost-effective compared to the Places API and allows customization of data and display options.\u003c/p\u003e\n"],["\u003cp\u003eThis product or feature is currently in the Experimental (pre-GA) phase, which means it has limited support and potential for incompatibility.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/places/android-sdk/places-ui-kit-overview \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/places-ui-kit-overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/places-ui-kit/overview \"View this page for the JavaScript platform docs.\")\n\n\nThe Places UI Kit component library lets you bring the familiar Google Maps user experience for\nPlaces to your apps and web pages, using the same data that powers the Places API. It includes a\nset of individual UI components that can be used independently, together, and in conjunction with\nother Google Maps Platform APIs to deliver a Places-rich experience with minimal cost and code.\n\n\nThe Places UI Kit includes the following HTML elements for rendering Places data:\n- [Place Details Elements](/maps/documentation/javascript/places-ui-kit/place-details) (Place Details and Place Details Compact) render details such as opening hours, website, and reviews for a selected place.\n- [Place Search Elements](/maps/documentation/javascript/places-ui-kit/place-list) (Place Nearby Search and Place Text Search) render a list of places in response to either a nearby search or text search query.\n- [Basic Place Autocomplete Element](/maps/documentation/javascript/places-ui-kit/basic-autocomplete) renders a text input field, supplies place predictions in a UI pick list, and returns a place ID for the selected place.\n- [Elevation](/maps/documentation/javascript/places-ui-kit/elevation) (experimental) renders elevation data as a numerical value for a single point, or as a visual plot for a path.\n| **Tip:** The Places UI Kit offers extensive visual customization options at no extra charge. See [Places UI Kit Custom Styling](/maps/documentation/javascript/places-ui-kit/custom-styling) for more information.\n\nKey features and capabilities\n - Incorporate Google's trusted experience starting with minimal code.\n - Bring Google Maps UI for Places to your apps at a lower cost than the Places API.\n - Choose the data and display options that best suit your needs.\n\nBilling\n- Places UI Kit requests are always billed at the [Places UI Kit API rate](/maps/billing-and-pricing/sku-details#places_ui-kit-request-ess-sku), regardless of which search method they use or what data types they return. For example, a Places UI Kit Nearby Search won't incur any additional charges for Places API Nearby Search Pro. Similarly, a Places UI Kit Place Details request may return photos, price, and rating for a selected place, but you will only be billed for the Places UI Kit Place Details request.\n\nNext step:\n[Get started with the Places UI Kit](/maps/documentation/javascript/places-ui-kit/get-started)"]]
