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