מיקום גיאוגרפי של מבקרים באתר בחינם עם ה-API של ipstack (סקירה)

מאז תחילתו הצנועה לפני יותר מ-25 שנה, הרשת העולמית התפתחה בדרכים שאפילו האנליסטים הטובים ביותר לא יכלו לחזות. מה שהיה בעצם כלי לעזור לחוקרים לשתף מידע, הוא התפתח לכלי צרכני שרבים מאיתנו פשוט לא יכולים לחיות בלעדיו. זה שינה היבטים רבים בחיינו והגענו לסמוך עליו, אולי יותר ממה שהיינו צריכים. זה הפך להיות כל כך נפוץ שזה משנה את ענף הקמעונאות. מרשתות גדולות של חנויות לבנים, הקמעונאים המובילים הם כעת שווקים מבוססי אינטרנט.

כדי להצליח, קמעונאים מקוונים צריכים לא רק להיות נוכחים באינטרנט, אלא הם גם צריכים לנצל באופן מלא את התכונות שלו. תכונה אחת כזו היא מיקום גיאוגרפי. טכנולוגיה זו יכולה לאפשר לקמעונאי לדעת את מיקומו של המבקר באתר שלו, תכונה שימושית כדי לאפשר להם להציג עלויות משלוח משוערות או להציג הצעות ספציפיות למיקום. אחת הדרכים הקלות ביותר להפיק תועלת ממיקום גיאוגרפי היא להשתמש ב-API ייעודי שניתן להזין בכתובת IP ושתחזיר כל מידע רלוונטי לגבי אותה כתובת. ה API של ipstack הוא מוצר כזה ואנו עומדים לגלות כיצד הוא עושה את הקסם שלו ומה הוא יכול לעשות עבורכם. נסתכל על הפונקציונליות הבסיסית של הכלי וכן כיצד להשתמש בו. נראה כיצד הוא מתפקד, איזה סוג של תיעוד ותמיכה זמין עבור המוצר ונראה את מבנה התמחור הפשוט למדי שלו.

הכירו את ה-ipstack

בבסיסו, ipstack הוא API למיקום גיאוגרפי שמשתמש במספר ספקי אינטרנט מחוברים זה לזה כדי לספק נתונים גיאוגרפיים מדויקים. אתה קורא ל-API מהקוד של האתר שלך והוא יחזיר שפע של נתונים גיאוגרפיים על משתמשי האתר שלך. אתה, כמובן, תקבל את המיקום הגיאוגרפי של המשתמש (האם זה לא העיקר?) אבל זה לא הכל. לדוגמה, הכלי יחזיר קישור לתמונה של דגל המדינה של המשתמש או גרסת אימוג'י שלו. יתר על כן, תקבל מידע לגבי האם המשתמש ניגש לאתר שלך דרך פרוקסי. אנו ניכנס לפרטים מעמיקים יותר על כל זה כאשר אנו מסתכלים בפרטים מעמיקים יותר במודולים הזמינים.

הפרויקט, שנקרא בתחילה freegeoip.net, ראה את האור ב-2009 כיוזמה בקוד פתוח כדי לעזור למפתחים. באמצעות שיפור מתמיד המבוסס על משוב משתמשים, הוא התפתח כשמונה שנים מאוחר יותר למוצר המלא שאנו בוחנים. במהלך תקופה זו, בסיס המשתמשים של המוצר גדל ליותר ממאה אלף לקוחות מרוצים. והם לא סתם לקוחות. ענקיות כמו מיקרוסופט או סמסונג משתמשות ב-API. כך גם Airbnb ו- HubSpot.

ה-API של ipstack משתמש בסכימה דינמית מאוד אשר מעדכנת את מסד הנתונים שלו מספר פעמים ביום, ומבטיחה את שלמות התוצאות המוחזרות. לצורך כך, ipstack שיתפה פעולה עם מספר ספקי אינטרנט גדולים ברחבי העולם. הכלי מבצע את כל התקשורת על פני ערוץ מוצפן SSL של 256 סיביות - באמצעות HTTPS - כדי לאבטח את כל העברות הנתונים. ניתן להחזיר תוצאות על ידי ה-API בפורמט XML או JSON, בהתאם לצרכים הספציפיים שלך.

אחד החלקים הטובים ביותר של ipstack API הוא המודולריות שלו. מודולים זמינים שונים מחזירים יותר ויותר נתונים על מיקומו של המשתמש. זה יוצר כלי מאוד גמיש. מהירות היא גם אחד היתרונות של המוצר. אתה קורא ל-API עם הפרמטר(ים) המתאימים ומקבל את התוצאות המבוקשות סופר מהיר. נכון לעכשיו, ipstack API מטפל ביותר משני מיליארד בקשות מדי יום והוא עדיין מגיב כמעט באופן מיידי. באמצעות שותפות עם ספקי אינטרנט שונים, המוצר יכול לכסות כ-2 מיליון מיקומים ולמעלה ממאתיים אלף ערים ברחבי העולם. זה גם תומך בכתובות IPv4 ו-IPv6.

איך מיקום גיאוגרפי עובד

לפני שנמשיך הלאה, בואו נעצור בקצרה ונסתכל במהירות על איך נראה מיקום גיאוגרפי. כפי שניתן לנחש מהשם של ipstack, זה קשור לכתובות IP. ניתן להשוות כתובות IP - במידה מסוימת - לכתובות דואר. לכל מכשיר המחובר לאינטרנט יש כתובת IP ייחודית. אבל כתובות ה-IP האלה לא רק מוקצות באופן אקראי לכל מכשיר. יש בזה הגיון מסוים. חלק מכתובת IP מזהה את המכשיר המחובר הבודד וחלק ממנה מזהה את הרשת שאליה הוא מחובר. וחלק הרשת עצמו מאורגן בצורה היררכית, קצת כמו עץ ​​ספריות של דיסקים במחשב. (אני מקווה שהמהנדסים מבין הקוראים שלנו יסלחו לי על הפשטת יתר זו.)

זה דומה לכתובת דואר עם מספר רחוב, שם רחוב, עיר, ובסופו של דבר, מדינה. ובדיוק כמו שלפוסט הבריטי אין מושג היכן ממוקמת כתובת בארה"ב כלשהי, הוא ישלח דואר בכיוון ארה"ב ל-USPS שידאג לנתב את הדואר למקום הנכון. ובדיוק כמו שאתה יכול להזין כמעט כל כתובת דואר בכלי כגון מפת גוגל ולקבל את המדויק המיקום המתאים, אתה יכול לשאול כלי כגון ה-API של ipstack עם כתובת IP כדי לקבל את מיקומו.

עם זאת, יש לזה כמה מגבלות. לדוגמה, לא תקבל את המיקום המדויק מכתובת ה-IP. מה שתקבל הוא כל מה שספק האינטרנט המספק את כתובת ה-IP יכול לספק. לעתים קרובות זה לא הרבה יותר מדויק מהעיר או מהשכונה הכללית, למרות שספקים מסוימים מחזירים יותר מידע מאחרים. כמו כן, אם המשתמש תובע VPN כדי לגשת לאתר שלך, מה שתקבל מבדיקה כזו הוא המיקום של שרת ה-VPN שבו הוא משתמש.

תכונות עיקריות של ה-API של ipstack

מפתחי ה-API של ipstack בחרו להשתמש בגישה מודולרית עם מוצר זה. הוא מורכב ממודולים שונים, כל אחד מחזיר סוג אחר של מידע. ישנם, למשל, מודולים של אזור זמן, מטבע, או אפילו אבטחה. אתה בוחר באיזה מודול להשתמש על ידי שימוש בפרמטרים המתאימים בעת שליחת הבקשה ל-ipstack API.

יש כמה יתרונות לגישה זו. ראשית, זה מקל על הטיפול בתגובה. אם היה רק ​​סוג אחד של בקשה להחזיר את כל הנתונים הזמינים לגבי כתובת IP, הקוד של האתר שלך היה צריך לנתח את כל התשובה כדי להביא את המידע שהוא צריך. כמו כן, שליחת בקשות קטנות יותר - עם תגובות קטנות יותר - יכולה לשפר את הביצועים.

בואו נסתכל לעומק על כל אחד מהמודולים הזמינים, איך לקרוא להם ואיך נראית התגובה האופיינית שלהם. זה ייתן לך סקירה ברורה למדי של למה לצפות מכלי רב עוצמה זה.

מודול המיקום

המודול הבסיסי ביותר של ipstack API הוא מודול המיקום. הוא מחזיר פרטים על המיקום הפיזי של כתובת ה-IP שסופקה בשאילתה. תקבל את המדינה של כתובת ה-IP, השפה הראשית או הרשמית שלה וכן אימוג'י עבור דגל המדינה שבו תוכל להשתמש כדי להתאים אישית את חוויית המשתמש שלך.

הנה תגובה טיפוסית לשאילתה ל-ipstack API. החלק הראשון כלול בכל שאילתה, ללא קשר למודול המבוקש:

ip: "142.243.254.224" שם מארח: "142.243.254.224" סוג: "ipv4" continent_code: "NA" continent_name: "צפון אמריקה" country_code: "CA" country_name: "קנדה" region_code: "QC" region_name: "קוויבק" עיר: "מונטריאול" zip: H2V. קו רוחב: 45.5178. קו אורך: -73.6046

רוב התכונות המוחזרות הן מובנות מאליהן, אבל יש לך תיעוד מפורט באתר של ipstack אם תזדקק לעזרה נוספת.

אבל מכיוון שאנחנו מדברים על מודול המיקום, בואו נסתכל איזה מידע נוסף מוחזר בעת השימוש בו:

מיקום: אובייקט {} geoname_id: null capital: "אוטווה" שפות: אובייקט {} קוד: "en" שם: "אנגלית" יליד: ""אנגלית"" קוד: "fr" שם: "צרפתית" יליד: ""Français "" דגל מדינה: " http://assets.ipstack.com/flags/ca.svg" country_flag_emoji: "??" country_flag_emoji_unicode: "U+1F1E8 U+1F1E6" calling_code: "1" is_eu: false

כפי שאתה יכול לראות, המידע הנוסף שאתה מקבל הוא בעיקר בירת המדינה, השפות השונות בשימוש במיקום זה, קישור לתמונה של דגל המדינה וה-unicode של המדינה אימוג'י.

מודול המטבעות

ניתן להשתמש במודול המטבע כדי לשפר עוד יותר את חווית המשתמש באתר שלך. זה נכון במיוחד עבור אתר קניות מכיוון שהוא יאפשר לך להציג מחירים במטבע של המשתמש שלך. הפרטים שסופקו כוללים את השם והסמל של המטבע המקומי וכן את שם הרבים שלו. ה-API לא ימיר מחירים למטבע המתאים, כמובן, אבל הוא יאפשר לך להשתמש ב-API אחר כדי להמיר את המחירים שלך למטבע המתאים למבקרים שלך. בואו נסתכל איך נראה הפלט ממודול המטבע:

מטבע: קוד אובייקט{}: "CAD" שם: "דולר קנדי" רבים: סמל "דולרים קנדיים": "CA$" symbol_native: "$"

מודול האבטחה

כנראה לא פופולרי - או שימושי - כמו המודולים הקודמים, מודול האבטחה עדיין מעניין. הוא מחזיר מידע על מספר היבטי אבטחה של החיבור הנכנס. לדוגמה, הוא יאמר לך אם הגישה לאתר מתבצעת דרך פרוקסי ואם כן, סוג ה-proxy או אם הבקשה הגיעה דרך רשת ה-tor. זה גם יכול להגיד לך שהבקשה היא מסורק ולא ממשתמש בפועל. ניתן להשתמש בסוג זה של מידע כדי למנוע גרידה. המודול גם מחזיר את רמת האיום הקשורה לכתובת ה-IP שסופקה, מה שעשוי לאפשר הגנה גסה מפני בקשות זדוניות. להלן מבט על התגובה האופיינית ממודול האבטחה:

אבטחה: אובייקט{} is_proxy: false proxy_type: null is_crawler: false crawler_name: null crawler_type: null is_tor: false רמת איום: "נמוכה" סוג האיום: null

מודול אזור הזמן

מודול נוסף שיכול להועיל כדי להתאים אישית את חווית המשתמש של מבקרי האתר שלך הוא מודול אזור הזמן. זה מחזיר כמה פרטים נוספים על - ניחשתם נכון - המבקרים באתר האינטרנט שלכם. אחד המקומות שבהם תוכל להשתמש בתכונה כזו באתרים העוסקים במידע רגיש לזמן. זה מאפשר לך להציג את השעה הנכונה בהתבסס על מיקום המשתמשים שלך.

המודול מספק מידע כמו קיזוז GMT, זמן משתמש נוכחי, קוד זמן ומיקום אזור זמן כפי שניתן לראות מתגובה לדוגמה זו:

time_zone: Object{} id: "America/Montreal" current_time: "2019-07-09T12:39:22-04:00" gmt_offset: -14400 קוד: "EDT" is_daylight_saving: true

מודול החיבור

אחרון חביב הוא מודול החיבור. זה די פשטני. כל מה שהוא מחזיר הוא מספר המערכת האוטונומית (AS) המשויך לכתובת ה-IP המקור וכן את שם ספק האינטרנט. ובכן, זה למעשה השם של בעל ה-AS ולא ספק האינטרנט. ארגונים מסוימים רושמים מערכת אוטונומית משלהם, כפי שקורה בדוגמה שלהלן:

חיבור: Object{} asn: 395399 isp: "City of Montreal"

זה כנראה הכי פחות שימושי מבין כל המודולים אבל חלקם ימצאו אותו שימושי למטרות אנליטיות שונות.

עבודה עם ה-API של ipstack

בדקנו איזה מידע ניתן להחזיר על ידי ה-API של ipstack, עכשיו זה הזמן לבדוק איך קוראים לזה. ה-API של ipstack מציע שלושה סוגים שונים של שאילתות כל אחת עם פרמטרים שונים. יש את ה-Standard Lookup, Bulk Lookup ו-Requester Lookup. בואו נראה איך הם שונים. זוהי תכונה נחמדה שכן, למשל, הבקשה בתפזורת מאפשרת לשלב מספר בקשות לאחת, ובכך להפחית את התקורה הכוללת ולאפשר תוצאות מהירות יותר. בואו נסתכל לעומק על כל סוג של בקשה.

חיפוש סטנדרטי

כפי שאולי ניחשתם, הבדיקה הסטנדרטית היא הבסיסית ביותר. הוא מחזיר את הפרטים על כתובת IP בודדת שאתה מספק בעת קריאה ל-ipstack API. זה די פשוט לשימוש והוא יעבוד עם כתובות IPv4 או IPv6. כדי להקל עוד יותר, התיעוד של המוצר מספק קוד לדוגמה עבור הבקשה הסטנדרטית גם ב-PHP (cURL) וגם ב-JavaScript (Jquery.ajax). אם האתר שלך נבנה באמצעות אחד מאלה, השימוש ב-API אינו פשוט. להלן דוגמה לקריאה טיפוסית ל-API באמצעות קוד HTML פשוט:

https://api.ipstack.com/123.123.123.123?access_key=YOUR_ACCESS_KEY

בדוגמה זו, YOUR_ACCESS_KEY יוחלף במפתח הגישה בפועל שקיבלת כשנרשמת לשירות. תכלול גם את כתובת ה-IP האמיתית עליה אתה רוצה מידע ולא את כתובת הדמה בדוגמה זו.

התוצאות עבור חיפוש רגיל כוללות את כל המודולים כברירת מחדל, אך פרמטרים נוספים מאפשרים לך לכוון את הבקשה לצרכים המדויקים שלך. כל הפרטים על הפרמטרים הזמינים מוסברים בבירור בתיעוד המוצר. כמו כן, תגובת ברירת המחדל היא אובייקט JSON אך פרמטרים יכולים לשנות זאת לפורמט XML.

חיפושים בכמות גדולה ומבקשים

הבדיקה בכמות גדולה מאפשרת לך לבקש נתונים כנגד מספר כתובות IP בתוך בקשה אחת. בדיוק כמו הבדיקה הרגילה, אתה יכול לקבל נתונים הן על כתובות IPv4 והן על כתובות IPv6. אתה יכול אפילו לערבב את שני סוגי הכתובות בבקשה אחת. הפורמט של הבקשה זהה לזה של חיפוש רגיל, פרט לכך שאתה מציין מספר כתובות IP מופרדות בפסיקים.

https://api.ipstack.com/123.123.123.123,124.124.124.124,125.125.125.125, 126.126.126.126?access_key=YOUR_ACCESS_KEY

סוג הבקשות האחרון שמציע ה-API של ipstack הוא בדיקת המבקשים. זה יחזיר מידע על כתובת ה-IP שממנה מגיעה הבקשה. זה סוג הבקשה שאתה מריץ מתוך סקריפט בצד הלקוח. כדי לבצע שיחת חיפוש מבקש, כל מה שאתה עושה הוא להשתמש במילת המפתח "בדוק" במקום כתובת IP. שאר פרמטרי הבקשות הזמינים זהים לאלו עבור סוגי בקשות אחרים.

https://api.ipstack.com/check? access_key=YOUR_ACCESS_KEY

כיצד מתפקד ה-API של ipstack?

ה-API של ipstack הוא, יותר מסביר, משהו שתשלבו באתר אינטרנט בזמן אמת. לדוגמה, ייתכן שתרצה להציג תוכן שונה על סמך מיקומו של הלקוח. כדי להשיג זאת, אתה צריך שה-API יפעל במהירות מדהימה. כל עיכוב בתגובת ה-API יתורגם לעיכובים בהצגת הדף ללקוח שלך, משהו שסביר להניח שתרצה להימנע ממנו. הדבר נכון לא משנה למה אתה משתמש בנתוני המיקום. זו הסיבה שזמן התגובה של הכלי שבו אתה משתמש הוא בעל חשיבות עליונה. בעוד שממשק API של מיקום גיאוגרפי יכול לספק פונקציונליות נחוצה, כישלון הביצוע שלו יכול להיות בעל השפעה הרת אסון.

מסיבות אלו, עליך לבחור API עם זמן תגובה טוב. עשינו הרבה מהעבודה הקשה של בדיקת תרחישים שונים והרצנו בדיקות עם כתובות IP בודדות או מרובות, חלקן עם יותר פרמטרים אופציונליים, חלקן עם פחות. היינו די מרוצים מהתוצאות וקיבלנו זמן תגובה די עקבי של כ-100 אלפיות השנייה, ללא קשר לבקשה. התגובה גם הייתה עקבית לאורך זמן ללא "שעות עומס" נראות לעין בהן הביצועים ייפגעו והיא גם הייתה דומה לא משנה מאיפה השקנו את הבקשות. נראה ששרתי ה-ipstack בנויים להתמודד עם העומס שהם מקבלים. בסך הכל, נראה שלשימוש ב-ipstack API כמעט ולא הייתה השפעה על תגובת האתר מנקודת מבטו של המשתמש.

תיעוד מוצר ותמיכה

לעתים קרובות אומרים שמוצר טוב רק כמו התיעוד שלו. אם זה נכון, לממשק ה-API של ipstack אין ממה לחשוש תיעוד קל למצוא, להשתמש ולהבין. איכות התיעוד נותנת גם מדד למידת אכפתיות של מפרסם תוכנה מהמשתמשים שלו. כאן שוב, אין מה לדאוג.

אחד הדברים הכי טובים בזה תיעוד המוצר זה, באופן מוזר, כמה מעט יש. הכל מתאים לדף אינטרנט יחיד ומסודר היטב, שבו תמצא בקלות את כל מה שאתה צריך. וכדי להקל עוד יותר, חלונית תפריט הופכת את הגישה לכל חלק נתון לפשוטה. התיעוד מכסה הכל משימוש בסוגי הבקשות השונים ועד להתאמה אישית של המענה.

במקרה מאוד לא סביר שבו לא תמצא את מה שאתה צריך בתיעוד, תמיכה זמינה גם. זה יכול לקחת קצת זמן כדי להגיע בהתחלה לתמיכה הטכנית, אבל ברגע שתעשה זאת, הם מגיבים די מהר.

תמחור

כַּמָה תוכניות תמחור זמינים עבור ה-API של ipstack. ברמה הנמוכה ביותר, שם התוכנית החינמית. כפי ששמו מרמז, זה בחינם. זה גם מוגבל במקצת. בתור התחלה, אתה יכול להריץ רק עד 10,000 שאילתות בחודש. זה גם כולל רק את מודול המיקום והגישה לתמיכה מוגבלת. עם זאת, זו יכולה להיות דרך מצוינת לבדוק את המוצר ולראות כיצד הוא יכול להשתלב בסביבה שלך.

הרמה הבאה היא התוכנית הבסיסית. זה נמכר ב-$9.99 לחודש או 95.90$ לשנה (20% הנחה) ומביא את מגבלת הבקשות ל-50,000 לחודש. זה גם מאפשר לך להשתמש במודול המטבע, אזור הזמן והחיבור. יתר על כן, תמיכה משופרת כלולה גם בתוכנית וכן אבטחה משופרת באמצעות שימוש בהצפנת SSL.

התוכנית הפופולרית ביותר היא התוכנית המקצועית שנמכרת ב-$49.99 לחודש או 479.90$ לשנה. זה נותן לך את כל מה שכלול בתוכנית הבסיסית אבל מעלה את מגבלת הבקשות החודשיות ל-500,000 וכולל גם את היכולת לבצע בקשות בכמות גדולה.

בראש תכנית הפלוס המקצועית. זה עולה $99.99 לחודש או $959.90 לשנה. זה זהה לתוכנית המקצועית אבל זה מאפשר עד 2 מיליון בקשות בחודש וזו התוכנית היחידה הכוללת את מודול האבטחה.

אם זה לא מספיק, יש גם תוכנית ארגונית הניתנת להתאמה אישית שניתן לארגן על ידי פנייה ל-ipstack. זה יכול לכלול בקשות חודשיות רבות ככל שתזדקק למגוון פתרונות מותאמים אישית המבוססים על הצרכים הספציפיים של הלקוח.

לסיכום

ה API של ipstack הוא מוצר מצוין שיאפשר לך לתפוס כמה שיותר מהנתונים שאתה יכול לקבל מכתובת IP במהירות ובקלות. יש לו זמן תגובה מדהים, תיעוד מעולה ותמיכה טובה שמשלבים את זה ולתמורה נהדרת לכסף. כמו כן, עצם העובדה שכמה ענקיות אינטרנט משתמשות בו היא כנראה עדות טובה לערך המוצר.

זה בהחלט מוצר שאני ממליץ עליו אם אתה בוחן ניצול הנתונים שניתן לאסוף עבור כתובת ה-IP של מבקר האתר שלך. ומכיוון שקיימת תוכנית חינמית - אם כי מוגבלת - זמינה, אין שום סיבה שלא תנסה אותה לפחות תראה בעצמך מה היא יכולה לעשות עבורך.