שימוש בשירות Places וב-Geocoding API עם עיצוב מבוסס-נתונים לגבולות

בחירת פלטפורמה: Android iOS JavaScript

אפשר להשתמש בשירות 'מקומות' Geocoding API עם SDK של מפות ל-Android לחיפוש אזורים, וגם לקבל מידע נוסף על מקומות. שירות 'מקומות' ו-Geocoding API הם חלופות חזקות ויציבות לקבלת מזהים של מקומות. אם אתם כבר משתמשים במזהי מקומות, תוכלו לעשות שימוש חוזר במזהים האלה עם עיצוב מבוסס-נתונים של גבולות.

הוספת שירות 'מקומות' והקידוד הגיאוגרפי של SDK של מפות לאפליקציות Android בדרכים הבאות:

  • Places SDK ל-Android היא ספריית Android שמכילה שיטות להצגת מידע על מקומות.
  • Places API מחזירה מידע על מקומות באמצעות בקשות HTTP.
  • הקלאס Geocoder יכול לבצע המרה של כתובות לכתובות גיאוגרפיות (geocoding) ולהפך (reverse geocoding) באופן דינמי מהקלט של המשתמש.
  • Geocoding API מאפשר לך כתובות סטטיות ומוכרות לקואורדינטות.

שימוש בשירות 'מקומות'

שימוש בחיפוש טקסט (חדש) כדי למצוא מזהה מקום

אפשר להשתמש בחיפוש טקסט (חדש) API ל-REST ב-Places API כדי לקבל מזהה מקום שכולל אזור על ידי ציון places.id במסכת השדות. שימוש ב חיפוש טקסט (חדש) כדי לבקש מזהי מקומות בלבד ללא חיוב. מידע נוסף

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

curl -X POST -d '{
  "textQuery" : "Trinidad, CA"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

איך משתמשים בהשלמה האוטומטית של 'מקומות' כדי למצוא אזורים

השלמה אוטומטית של מקומות בשירות Places SDK ל-Android מספק דרך נוחה לאפשר שהמשתמשים שלכם מחפשים לפי אזורים. כדי להגדיר את שירות ההשלמה האוטומטית של 'מקומות' ל- החזרת אזורים בלבד, שימוש AutocompleteSupportFragment.setTypesFilter(List) כדי להגדיר את מסנן הסוג לPlaceTypes.REGIONS.

קבלת פרטים על אזור מסוים

פרטי המקום בשירות Places SDK ל-Android מחזיר נתונים עבור אזור מסוים, שימושי מאוד. לדוגמה, אפשר:

  • חיפוש מזהים של מקומות גבולות לפי שמות של מקומות.
  • קבלת אזור התצוגה לשינוי מרחק התצוגה עד לגבול.
  • מקבלים את סוג התכונה עבור הגבול (לדוגמה locality).
  • מקבלים את הכתובת בפורמט 'שם המקום, מדינה, מדינה' באזור ארצות הברית (לדוגמה, 'Ottumwa, IA, USA').
  • לקבל נתונים שימושיים אחרים, כמו תמונות.

שימוש ב-Geocoding API

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

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

בדוגמה הבאה נעשה שימוש בכתובת (שעברה בריחה מ-URL) כדי לשלוח בקשה ל-Geocoding API:

https://maps.googleapis.com/maps/api/geocode/json?address=1600%20Amphitheatre%20Pkwy%20Mountain%20View%20CA&key=YOUR_API_KEY

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

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

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

  • administrativeArea
  • country
  • locality
  • postalCode

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

https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY