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

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

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

אפשר להוסיף את שירות Places ואת השירות להמרת כתובות ל-Maps SDK לאפליקציות ל-Android בדרכים הבאות:

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

שימוש בשירות Places

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

כדי לקבל מזהה מקום שכולל נתוני אזור, אפשר להשתמש ב-API ל-REST של Text Search (New) ב-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, יישוב או מיקוד, אפשר להחיל סינון רכיבים על הקריאה לשירותי הגיאוקוד.
  • אפשר להשתמש בקידוד גיאוגרפי הפוך כדי למצוא מזהי מקומות לפי קו רוחב וקו אורך ואפילו להחזיר מזהי מקומות לכל הרכיבים המיקום.

הדוגמה הבאה משתמשת בכתובת (עם קוד Escape) כדי לשלוח בקשה אל 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