Câu hỏi thường gặp về mã hóa địa lý

Câu hỏi thường gặp này đề cập đến những câu hỏi dành riêng cho Geocoding API. Hãy tham khảo Câu hỏi thường gặp về Google Maps Platform cho các câu hỏi thường gặp về tất cả Google Maps Platform. Xem thêm Các phương pháp hay nhất khi mã hoá địa lý địa chỉ.

Khắc phục sự cố

Khắc phục sự cố

Tôi nhận được nhiều truy vấn hơn trả về ZERO_RESULTS bằng trình mã hoá địa lý. Nội dung có vấn đề gì?

Trong trình mã hoá địa lý, các truy vấn mơ hồ, chưa hoàn chỉnh và có định dạng không chính xác (chẳng hạn như địa chỉ sai chính tả hoặc không tồn tại) có thể tạo ra ZERO_RESULTS. Nếu không tìm thấy địa chỉ, bạn nên trả về ZERO_RESULTS thay vì kết quả một phần (ví dụ: chỉ trả về vùng ngoại ô thay vì địa chỉ).

Nếu ứng dụng của bạn xử lý hoạt động đầu vào của người dùng về địa chỉ, thì tính năng Place Autocomplete trong Places API có thể mang lại kết quả chất lượng hơn. Tính năng Place Autocomplete cho phép người dùng chọn trong một nhóm kết quả dựa trên nội dung họ đã nhập, nhờ đó người dùng có thể chọn giữa các kết quả có tên tương tự và điều chỉnh cụm từ tìm kiếm nếu họ viết sai chính tả địa chỉ.

Nếu có một ứng dụng xử lý các truy vấn không rõ ràng hoặc chưa hoàn chỉnh hoặc các truy vấn có thể chứa lỗi, bạn nên sử dụng tính năng Place Autocomplete trong Places API thay vì trình mã hoá địa lý chuyển tiếp có trong Geocoding API. Để biết thêm thông tin chi tiết, hãy xem Các phương pháp hay nhất khi mã hoá địa lý địa chỉ và bài đăng trên blog về hoạt động mã hoá địa lý địa chỉ trong API Google Maps.

Tôi cần phản hồi nhanh và trình mã hoá địa lý quá chậm đối với ứng dụng của tôi. Tôi có thể dùng công cụ nào để nhận được phản hồi nhanh hơn?

Chúng tôi đề xuất các ứng dụng phản hồi hoạt động đầu vào của người dùng và do đó có độ trễ cao, nên sử dụng tính năng Place Autocomplete trong Places API (cũng có trong JavaScript, Android hoặc iOS) thay vì tính năng mã hoá địa lý địa chỉ. Place Autocomplete được tối ưu hoá để sử dụng một cách tương tác, do đó có độ trễ rất thấp.

Tính năng mã hoá địa lý địa chỉ trong Geocoding API được tối ưu hoá để sử dụng với các địa chỉ đầy đủ, rõ ràng, có định dạng phù hợp (chẳng hạn như địa chỉ giao hàng được nhập vào biểu mẫu trực tuyến), do đó có độ trễ cao hơn so với Place Autocomplete. Trình chuyển đổi địa lý xuôi có phạm vi phủ sóng rộng hơn và chất lượng kết quả cao hơn, nhưng độ trễ cao hơn một chút.

Làm cách nào để giảm độ trễ trên Directions API (Cũ) và Distance Matrix API (Cũ)?

Thay vì địa chỉ, hãy sử dụng mã địa điểm để chỉ định điểm tham chiếu, điểm bắt đầu và điểm đến. Bạn nên lấy mã địa điểm từ tính năng Tự động hoàn thành địa điểm trong Places API hoặc Thư viện địa điểm trong Maps JavaScript API. Bạn cũng có thể xem thông tin về lựa chọn placeIdOnly. Lựa chọn này có thể được dùng để giảm chi phí của tính năng Place Autocomplete.

Khi được truy vấn bằng một chuỗi địa chỉ thay vì mã địa điểm hoặc latlng, Directions API (Phiên bản cũ) hoặc Distance Matrix API (Phiên bản cũ) sẽ sử dụng cùng một phần phụ trợ như Geocoding API để chuyển đổi địa chỉ đó thành mã địa điểm trước khi tính toán chỉ đường. Place Autocomplete nhanh hơn tính năng mã hoá địa lý địa chỉ. Đối với những ứng dụng sử dụng Directions API (cũ) hoặc Distance Matrix API (cũ) trong các trường hợp có độ trễ cao, chẳng hạn như phản hồi thông tin đầu vào của người dùng, bạn nên sử dụng Place Autocomplete để lấy mã địa điểm tương ứng với những địa chỉ đó và truyền mã địa điểm đến Directions API (cũ) hoặc Distance Matrix API (cũ). Phương pháp này giúp giảm đáng kể độ trễ. Hãy xem tài liệu của chúng tôi để biết ví dụ về cách sử dụng tính năng Place Autocomplete với chỉ đường.

Làm cách nào để báo cáo lỗi trong trình mã hoá địa lý?

Nếu bạn có báo cáo lỗi hoặc yêu cầu về tính năng cho dịch vụ bộ mã hoá địa lý xuôi, hãy cho chúng tôi biết bằng cách sử dụng trình theo dõi sự cố công khai của chúng tôi.

Bộ mã hoá địa lý không mang lại kết quả tốt cho trường hợp sử dụng của tôi. Luôn sẵn sàng giúp bạn

Hãy cho chúng tôi biết bằng cách sử dụng trình theo dõi sự cố công khai của chúng tôi, đồng thời chia sẻ một vài cụm từ tìm kiếm cụ thể để chúng tôi có thể điều tra xem có lỗi hoặc vấn đề hệ thống nào gây ra vấn đề về chất lượng kết quả hay không, hoặc liệu có thay đổi nào mà chúng tôi có thể thực hiện đối với hướng dẫn về các phương pháp hay nhất để giúp nhà phát triển đạt được kết quả tốt hơn hay không.

Làm cách nào để nhận được kết quả tốt nhất từ trình mã hoá địa lý bằng cách sử dụng tính năng lọc thành phần?

Trong bộ mã hoá địa lý, bộ lọc thành phần chỉ thực thi các quy định hạn chế về postal_code và country. Các ví dụ sau đây minh hoạ cách sử dụng bộ lọc thành phần hiệu quả nhất, tuỳ thuộc vào kết quả bạn cần. Trong các URL yêu cầu mẫu, hãy nhớ thay thế "YOUR_API_KEY" bằng khoá API thực tế của bạn.

  • Để giới hạn mã bưu chính ở một quốc gia cụ thể, hãy nhớ chỉ định hạn chế theo quốc gia bằng cách sử dụng mã quốc gia ISO 3166-2. Ví dụ: components=country:CH|postal_code:8000 trả về "8000 Zürich, Switzerland". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Để hạn chế các cụm từ tìm kiếm ở một quốc gia cụ thể, hãy nhớ chỉ định chế độ hạn chế theo quốc gia bằng cách sử dụng mã quốc gia ISO 3166-2. Tên quốc gia và các từ viết tắt khác có thể không cho ra kết quả giống như mã quốc gia.

    Ví dụ:

    • Mã hoá địa lý cho components=country:FRA|locality:gallus trả về tiểu khu Gallus ở Frankfurt am Main, Đức. Điều này là do mã quốc gia gồm 3 chữ cái cho Pháp (FRA) không được hỗ trợ, do đó, mọi quốc gia đều được phép và kết quả ở Frankfurt phù hợp hơn bất kỳ kết quả nào ở Pháp. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Geocoding API không nhất thiết phải trả về nhiều kết quả cho các truy vấn không rõ ràng. Những truy vấn như vậy sẽ được trả lời tốt hơn bằng tính năng Tự động hoàn thành địa điểm.

    Ví dụ:

    • Mã hoá địa lý cho components=country:US|locality:madrid trả về "Madrid, NM 87010, Hoa Kỳ" nhưng không trả về bất kỳ thành phố nào khác ở Hoa Kỳ có tên "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Việc sử dụng tính năng Place Autocomplete cho input=madrid&components=country:us&types=(regions), đồng thời chỉ định một khung nhìn bằng cách sử dụng location và radius để điều chỉnh kết quả vị trí, sẽ tạo ra một phản hồi có nhiều thành phố ở Hoa Kỳ tên là "Madrid". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY