نمای کلی API مکان جغرافیایی

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

چرا از API موقعیت جغرافیایی استفاده کنیم؟

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

کارهایی که می‌توانید با API موقعیت جغرافیایی انجام دهید

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

نحوه عملکرد API موقعیت جغرافیایی

API موقعیت‌یابی جغرافیایی (Geolocation API) از فیلدهای داده دستگاه تلفن همراه، داده‌های دکل‌های تلفن همراه و داده‌های آرایه نقاط دسترسی WiFi برای بازگرداندن مختصات عرض/طول جغرافیایی و شعاع دقت استفاده می‌کند. این API یک درخواست HTTPS POST را به همراه یک بدنه درخواست ساختار یافته JSON به نقطه انتهایی خود می‌پذیرد. مثال زیر URL درخواست و یک نمونه بدنه درخواست را نشان می‌دهد:

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
}'
این API می‌تواند داده‌های مربوط به تعدادی از فیلدهای داده سلولی رایج را همانطور که در زیر نشان داده شده است، برگرداند.

منابع

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

منابع داده داده‌ها بازگردانده شدند قالب بازگشتی
فیلدهای داده دستگاه تلفن همراه مانند اطلاعات اپراتور، دستگاه و شبکه. مختصات عرض/طول جغرافیایی و شعاع دقت جی‌سون
داده‌های دکل‌های تلفن همراه ، مانند کد منطقه مکانی و کد کشورهای تلفن همراه.
داده‌های نقاط دسترسی وای‌فای ، مانند آدرس مک و قدرت سیگنال.

نحوه استفاده از API موقعیت جغرافیایی

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

کتابخانه‌های کلاینت موجود

این API را به زبان دلخواه خود از طریق یکی از کتابخانه‌های کلاینت زیر فراخوانی کنید:

کلاینت جاوا، کلاینت پایتون، کلاینت گو و کلاینت نود.جی‌اس برای سرویس‌های نقشه‌های گوگل، کتابخانه‌های کلاینتی هستند که توسط جامعه پشتیبانی می‌شوند و تحت مجوز آپاچی ۲.۰ متن‌باز می‌باشند. آن‌ها را از گیت‌هاب دانلود کنید، جایی که می‌توانید دستورالعمل‌های نصب و نمونه کد را نیز پیدا کنید.

قدم بعدی چیست؟