بررسی اجمالی

پلتفرم را انتخاب کنید: سرویس وب جاوا اسکریپت اندروید iOS

قبل از شروع: قبل از شروع استفاده از Places SDK برای iOS، به یک پروژه با حساب صورت‌حساب و Places API نیاز دارید. توصیه می‌کنیم چندین مالک پروژه و مدیر صورت‌حساب ایجاد کنید تا همیشه فردی با این نقش‌ها در اختیار تیمتان باشد. برای کسب اطلاعات بیشتر، به راه‌اندازی در Cloud Console مراجعه کنید.

معرفی

Places SDK برای iOS به شما امکان می‌دهد برنامه‌های آگاه از موقعیت مکانی بسازید که به طور متناوب به مشاغل محلی و سایر مکان‌های نزدیک دستگاه پاسخ می‌دهند. این بدان معنی است که می توانید برنامه های غنی را بر اساس مکان هایی که برای کاربر معنی دارند بسازید.

مفاهیم

مکان به عنوان یک فضای فیزیکی که یک نام دارد تعریف می شود. راه دیگری برای تفکر در مورد یک مکان این است که آن مکان هر چیزی است که می توانید روی نقشه پیدا کنید. به عنوان مثال می توان به مشاغل محلی، نقاط دیدنی و مکان های جغرافیایی اشاره کرد. در API، یک مکان با GMSPlace Class Reference نشان داده می شود. این شامل اطلاعاتی مانند نام مکان و آدرس آن، موقعیت جغرافیایی، شناسه مکان، شماره تلفن، نوع مکان، آدرس وب سایت و غیره است.

توجه: هر زمان که برنامه شما اطلاعاتی را درباره مکان‌های منبع‌شده از Places SDK برای iOS نشان می‌دهد، برنامه باید همه اسناد مرتبط را که توسط API برگردانده شده است را نیز نشان دهد. مستندات مربوط به نمایش اسناد را ببینید.

نسخه SDK خود را انتخاب کنید

Places SDK برای iOS نسخه 8.5.0 از دو نسخه SDK پشتیبانی می کند: Places SDK موجود برای iOS و Places SDK برای iOS (جدید) ، نسل بعدی SDK.

اولین وظیفه شما این است که تصمیم بگیرید از کدام SDK استفاده کنید. اگر شما یک مشتری جدید یا مشتری فعلی هستید که قبلاً از SDK استفاده می‌کنید، این درست است. برای یادگیری تفاوت های کلیدی بین دو نسخه SDK، به انتخاب نسخه SDK خود مراجعه کنید.

قیمت گذاری برای هر نسخه SDK

نسخه انتخابی شما از SDK قیمت جستجوی متن را کنترل می کند. Places SDK برای iOS (جدید) از یک مدل قیمت گذاری ساده پشتیبانی می کند به طوری که شما فقط برای داده هایی که استفاده می کنید هزینه پرداخت می کنید. برای اطلاعات دقیق قیمت گذاری برای هر دو SDK، استفاده و صورتحساب را ببینید.

توجه: قیمت جزئیات مکان، تکمیل خودکار مکان، عکس‌ها و مکان فعلی برای هر دو SDK یکسان است.

نمای کلی API

به مشتریان خود کمک کنید مکان هایشان و آنچه را که در اطرافشان است کشف کنند:

• Place Details اطلاعات مکان‌ها، از جمله نام و آدرس مکان، موقعیت جغرافیایی مشخص شده به عنوان مختصات طول و عرض جغرافیایی، نوع مکان (مانند کلوپ شبانه، فروشگاه حیوانات خانگی، موزه) و غیره را برمی‌گرداند.
• Current Place فهرستی از مکان‌هایی را که دستگاه کاربر آخرین بار در آن‌ها قرار دارد را همراه با نشانه‌ای از احتمال نسبی برای هر مکان برمی‌گرداند.
• تکمیل خودکار مکان به طور خودکار نام و/یا آدرس یک مکان را با تایپ کاربران پر می کند.
• Place Photos تصاویری با کیفیت بالا از یک مکان برمی گرداند.
• شناسه مکان شناسه منحصر به فرد یک یا چند مکان را برای بازیابی اطلاعات مکان در صورت تقاضا ذخیره می کند.
• جستجوی متن اطلاعاتی درباره مجموعه‌ای از مکان‌ها بر اساس جستجوی متنی برمی‌گرداند.

سایر نکات برجسته API عبارتند از:

• تشخیص دقیق مکان در قدرت کم با اسکن Wi-Fi.
• حافظه پنهان روی دستگاه: بیشتر درخواست‌ها برای Places SDK برای iOS ممکن است شامل یک سفر رفت و برگشت به سرور Google باشد، اما شما همچنین می‌توانید داده‌ها را به‌مدت 30 روز به صورت محلی ذخیره کنید.

سیاست ها و شرایط

همه برنامه‌هایی که از Places SDK برای iOS استفاده می‌کنند باید از الزامات توضیح داده شده در شرایط خدمات پلتفرم Google Maps و نشان‌داده‌ها پیروی کنند.