نمای کلی Geolocation API

Geolocation API سرویسی است که درخواست HTTPS را با دکل تلفن همراه و نقاط دسترسی Wi-Fi که کارخواه برنامه همراه می‌تواند شناسایی کند می‌پذیرد. برای هر ورودی معتبر، مختصات طول/عرض جغرافیایی و شعاعی که نشان‌دهنده دقت نتیجه است را برمی‌گرداند.

چرا از Geolocation API استفاده کنیم

از Geolocation API برای مکان‌یابی دستگاه‌های همراهی که ویژگی‌های مکان‌یابی جغرافیایی داخلی ندارند استفاده کنید.

کارهایی که می‌توانید با Geolocation API انجام دهید

با Geolocation API، می‌توانید از داده‌های زمین‌مکانی دکل‌های تلفن همراه و گره‌های WiFi برای دریافت مکان دستگاهی که موقعیت جغرافیایی یا GPS داخلی ندارد استفاده کنید.

نحوه عملکرد Geolocation API

«میانای برنامه‌سازی کاربردی مکان جغرافیایی» از فیلدهای داده دستگاه تلفن همراه، داده‌های دکل تلفن همراه، و داده‌های آرایه نقطه دسترسی Wi-Fi برای برگرداندن مختصات طول/عرض جغرافیایی و شعاع دقت استفاده می‌کند. این سرویس درخواست HTTPS POST را به نقطه پایان خود همراه با بدنه درخواست ساختاریافته JSON می‌پذیرد. مثال زیر نشانی وب درخواست و یک نمونه از بدنه درخواست را نشان می‌دهد:

curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d \
'{ "homeMobileCountryCode":310,
   "homeMobileNetworkCode":410,
   "radioType":"gsm",
   "carrier":"Vodafone",
   "considerIp":true
}'
 «میانای برنامه‌سازی کاربردی» می‌تواند داده‌های تعدادی از فیلدهای رایج داده شبکه تلفن همراه را که در زیر نشان داده شده است برگرداند.

منابع

جدول زیر فیلدهای موجود در بدنه درخواست تماس نقطه پایانی مکان جغرافیایی را به‌همراه نوع داده‌های ارائه‌شده از چنین پُرسمان‌هایی خلاصه می‌کند.

منابع داده داده‌ها برگردانده شد قالب برگشت
فیلدهای داده دستگاه تلفن همراه مثل اطلاعات شرکت مخابراتی، دستگاه، و شبکه. مختصات طول/عرض جغرافیایی و شعاع دقت (قالب) JSON
داده‌های دکل تلفن همراه، مثل پیش‌شماره منطقه و کدهای کشور تلفن همراه.
داده‌های نقاط دسترسی Wi-Fi، مثل مک آدرس و قدرت سیگنال.

نحوه استفاده از Geolocation API

۱ راه‌اندازی کنید با راه‌اندازی پروژه Google Cloud شروع کنید و دستورالعمل‌های راه‌اندازی بعدی را تکمیل کنید.
۲ درخواست مکان جغرافیایی را امتحان کنید وقتی کلید میانای برنامه‌سازی کاربردی را دریافت کردید، می‌توانید آزمایش Geolocation API را بااستفاده از cURL یا Postman شروع کنید. برای جزئیات، به نمونه درخواست‌ها در راهنمای درخواست‌ها و پاسخ‌های مکان‌یابی جغرافیایی مراجعه کنید.
3 دریافت cellID از دکل‌های رادیویی مختلف برای دسترسی به برج‌های قدیمی‌تر و جدیدتر، به‌ترتیب محاسبه cellID و محاسبه newRadioCellID را ببینید.
‫۴ آشنایی با اصول پاسخ برای آماده شدن برای استفاده از داده‌های ارتفاع برای برنامه‌تان، پاسخ‌های داده‌های زمین‌مکان را کاوش کنید. برای جزئیات، پاسخ‌های زمین‌مکان را ببینید.

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

این «میانای برنامه‌سازی کاربردی» را به زبان دلخواهتان ازطریق یکی از کتابخانه‌های مشتری زیر فراخوانی کنید:

«کارخواه Java»، «کارخواه Python»، «کارخواه Go»، و «کارخواه Node.js» برای «سرویس‌های Google Maps» کتابخانه‌های کارخواه با پشتیبانی انجمن هستند که تحت پروانه Apache 2.0 متن‌باز شده‌اند. آن‌ها را از GitHub بارگیری کنید، در آنجا می‌توانید دستورالعمل‌های نصب و کد نمونه را نیز پیدا کنید.

قدم بعدی چیست