Geocoding API הוא שירות שמקבל מקום ככתובת, קואורדינטות של קו רוחב וקו אורך או מזהה מקום. הוא ממיר את הכתובת לקואורדינטות של קווי רוחב ואורך ולמזהה מקום, או ממיר קואורדינטות של קווי רוחב ואורך או מזהה מקום לכתובת.
מה אפשר לעשות עם Geocoding API
אתם יכולים להשתמש ב-Geocoding API כדי לקבל נתוני המרה של כתובת אחת או יותר או של מקום אחד או יותר, כולל:
גרסה 4 של Geocoding API כוללת את נקודות הקצה הבאות:
- המרת כתובת לקואורדינטות — קואורדינטות גיאוגרפיות של כתובות. התהליך הזה נקרא גם המרה ישירה של כתובות לקואורדינטות.
- המרת מיקום לקואורדינטות — כתובות לקבוצות של קואורדינטות של קווי רוחב ואורך. התהליך הזה נקרא גם המרת קואורדינטות לכתובות (reverse geocoding).
- המרת מקומות לקואורדינטות — אחזור כתובת ממזהה מקום.
- חיפוש יעדים — חיפוש יעד לפי כתובת, מזהה מקום או מיקום.
אתם יכולים לקבוע איפה התוצאות יופיעו ולהגביל את התוצאות לאזור, למחוז או למיקוד מסוים.
נסה את ההדגמה
איך Geocoding API פועל
Geocoding API מבצע גם המרת כתובות לקואורדינטות וגם המרת קואורדינטות לכתובות:
- המרת כתובות לקואורדינטות (geocoding): המרת כתובות כמו "1600 Amphitheatre Parkway, Mountain View, CA" לקואורדינטות של קו רוחב וקו אורך או למזהי מקומות. אתם יכולים להשתמש בקואורדינטות האלה כדי להציב סמנים במפה, או כדי למרכז את המפה או לשנות את המיקום שלה בתוך מסגרת התצוגה.
- המרת קואורדינטות לכתובות (reverse geocoding): המרת קואורדינטות של קווי רוחב ואורך או מזהה מקום לכתובת קריאה לאנשים. אפשר להשתמש בכתובות במגוון תרחישים, כולל משלוחים או איסופים.
בטבלה הבאה מפורטים המשאבים שזמינים דרך Geocoding API, וגם הנתונים שכל שיטה מחזירה.
| מקורות נתונים | נתונים שהוחזרו | פורמט ההחזרה |
|---|---|---|
| המרת כתובות לקואורדינטות (geocoding) | הפונקציה מחזירה את הכתובת, את רכיבי הכתובת ואת סוגי הכתובות. לעיון במאמרי העזרה בנושא תגובות של המרת כתובות לקואורדינטות |
|
| המרת קואורדינטות לכתובות (reverse geocoding) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. המסמכים בנושא תגובה להמרת קואורדינטות לכתובות | |
| המרת כתובות של מקומות לקואורדינטות (geocoding) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. המסמכים בנושא תגובת המרת כתובות לקואורדינטות של מקומות | |
| חיפוש יעד | הפונקציה מחזירה מידע מפורט על יעדים שונים על סמך קריטריונים שונים של קלט, כמו כתובת, מזהה מקום או קואורדינטות של קו רוחב וקו אורך. למידע נוסף על חיפוש יעד |
הפעלת ערוצי במה
בגרסה 4 של Geocoding API יש ערוצים נפרדים לתכונות GA, לתכונות בגרסת טרום-השקה (Preview) ולתכונות ניסיוניות. אם אתם רוצים להשתמש בתכונות בגרסת טרום-השקה (Preview) או בתכונות ניסיוניות, הקפידו לציין את הערוץ הנכון בבקשה. לדוגמה, כדי לגשת לתכונות של נקודת הקצה (endpoint) של Destinations בגרסה הניסיונית, משתמשים בבקשת ה-HTTP הבאה: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| שלב ההשקה | שם הערוץ |
|---|---|
| GA | /v4/ |
| תצוגה מקדימה | /v4beta/ |
| ניסיוני | /v4alpha/ |
- בחומר העזר בנושא REST מפורטים ומתוארים כל משאבי ה-REST הזמינים.
- במאמר שלבי השקה תוכלו לקרוא בהרחבה על כל שלב.
תכונות ב-Geocoding API גרסה 4
גרסה 4 של Geocoding API כוללת את התכונות החדשות הבאות.
שיטת החיפוש של היעד
בגרסה 4 יש שיטת חיפוש יעדים שמאפשרת לאחזר מידע מפורט על יעדים שונים על סמך קריטריונים שונים של קלט, כמו כתובת, מזהה מקום או קואורדינטות של קו רוחב וקו אורך. התשובה כוללת סיכומים מבוססי-AI ואסימונים של נקודות ניווט שמכילים מידע לפי הקשר שאפשר להעביר ל-Navigation SDK כדי לקבל מסלול מדויק.
מיושם בפלטפורמה הרגילה של Google Cloud
Geocoding API v4 מוטמע בתשתית השירות ב-Google Cloud. ההטמעה הזו מספקת פלטפורמה מאובטחת ומהימנה יותר, עם אפשרויות אבטחה משופרות כמו OAuth. עיצוב ה-API הסטנדרטי הזה מספק רמה של עקביות בין ממשקי ה-API, שמשפרת את יעילות הפיתוח באמצעות Geocoding API v4.
נוספה תמיכה ב-OAuth
בגרסה 4 של Geocoding API אפשר להשתמש ב-OAuth 2.0 לאימות. Google תומכת בתרחישים נפוצים של OAuth 2.0, כמו אלה של שרת אינטרנט.
נוספה תמיכה במסכת שדה
משתמשים במסכות שדות כדי לציין איזה מידע התשובה צריכה להחזיר. בשיטות Geocode an address, Geocode a location ו-Place geocoding, כל השדות באובייקט התגובה מוחזרים כברירת מחדל. ב-method Search for destinations, צריך לציין מסכת שדה בבקשת ה-API.
אבטחת API
Geocoding API v4 הוא ממשק API לתקשורת שרת-אל-שרת. קריאות ישירות בצד הלקוח מדפדפן חושפות את מפתחות ה-API לסיכון משמעותי של גניבה ושימוש לרעה, כי הגבלות על גורמים מפנים מסוג HTTP לא מספקות הגנה מספיקה לנקודות קצה של שירותי אינטרנט.
מומלץ מאוד לשלוח קריאה ל-Geocoding API v4 משרת בקצה העורפי שלכם. לפרטים נוספים על דפוסי הטמעה מאובטחים וחלופות לצרכים בצד הלקוח, ראו שיקולי אבטחה.