Geocoding API הוא שירות שמקבל מקום ככתובת, כקו רוחב וקו אורך או כמזהה מקום. היא ממירה את הכתובת לקואורדינטות של קו רוחב וקו אורך ולמזהה מקום, או ממירה קואורדינטות של קו רוחב וקו אורך או מזהה מקום לכתובת.
מה אפשר לעשות עם Geocoding API
אתם יכולים להשתמש ב-Geocoding API כדי לקבל נתוני קידוד גאוגרפי של כתובת או מקום אחד או יותר, כולל:
הגרסה הזו של Geocoding API v4 כוללת את נקודות הקצה הבאות:
- (תצוגה מקדימה) המרת כתובת לקואורדינטות גיאוגרפיות – קואורדינטות גיאוגרפיות של כתובות. נקרא גם קידוד גיאוגרפי קדימה.
- (תצוגה מקדימה) המרת מיקום לקואורדינטות גיאוגרפיות – כתובות של קבוצות קואורדינטות של קווי רוחב ואורך. נקרא גם המרת קואורדינטות לכתובות (reverse geocoding).
- (תצוגה מקדימה) קידוד גיאוגרפי של מקום – אחזור כתובת ממזהה מקום.
- (תצוגה מקדימה) חיפוש יעדים — חיפוש יעד לפי כתובת, מזהה מקום או מיקום.
אתם יכולים לקבוע איפה התוצאות יופיעו, ולצמצם את התוצאות לאזור, למחוז או למיקוד מסוימים.
איך Geocoding API פועל
Geocoding API מבצע המרת כתובות לקואורדינטות (geocoding) והמרת קואורדינטות לכתובות (reverse geocoding):
- גיאו-קידוד: המרה של כתובות כמו '1600 Amphitheatre Parkway, Mountain View, CA' לקואורדינטות של קווי רוחב ואורך או למזהי מקומות. אפשר להשתמש בקואורדינטות האלה כדי להציב סמנים במפה, או כדי למרכז או למקם מחדש את המפה בתוך מסגרת התצוגה.
- גיאו-קידוד הפוך: המרת קואורדינטות של קו רוחב וקו אורך או מזהה מקום לכתובת שניתן לקרוא. אפשר להשתמש בכתובות במגוון תרחישים, כולל משלוחים או איסופים.
בטבלה הבאה מפורטים המשאבים שזמינים דרך Geocoding API, לצד הנתונים שכל נקודת קצה מחזירה.
| מקורות נתונים | הנתונים שהוחזרו | פורמט ההחזרה |
|---|---|---|
| המרת כתובות לקואורדינטות (geocoding) | הפונקציה מחזירה כתובת, רכיבי כתובת וסוגי כתובות. אפשר לעיין במסמכי התיעוד בנושא תגובת קידוד גיאוגרפי. |
|
| המרת קואורדינטות לכתובות (reverse 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, כל השדות באובייקט התגובה מוחזרים כברירת מחדל. בנקודת הקצה חיפוש יעדים, צריך לציין מסכת שדות בבקשת ה-API.
אין עלות לשימוש במהלך תקופת ההרצה
Geocoding API v4 נמצא בשלב התצוגה המקדימה לפני הזמינות הכללית, ואין חיוב על השימוש ב-API במהלך התצוגה המקדימה. הקריאות ל-API יופיעו בדף החיוב במסוף Cloud, אבל החיובים יהיו 0$.
משוב
זו תכונה בגרסת טרום-השקה (Preview). נשמח לקבל משוב בכתובת geocoding-feedback-channel@google.com.