Java程序下载谷歌静态路线地图异常，同URL浏览器正常求助

算力阿峰

2026-5-21

Hey there, let's dig into this problem you're having with downloading Google Static Maps via Java. I spot a critical red flag right away in the URL snippet you shared—let's break down the fixes and checks step by step.

1. Fix the URL Entity Escaping Issue

The & in your URL is an HTML entity for the & character. Browsers automatically parse & back to & when handling URLs, but Java's HTTP clients don't do this conversion automatically. This means your Java code is sending a malformed URL where parameters are separated by & instead of the correct &, which is almost certainly causing the wrong image to be returned.

For example, your current URL snippet:

String mapImgUrl = "https://maps.googleapis.com/maps/api/staticmap?size=300x300&amp;pa...";

Needs to be corrected to:

String mapImgUrl = "https://maps.googleapis.com/maps/api/staticmap?size=300x300&pa...";

2. Additional Troubleshooting Steps

If fixing the URL escaping doesn't resolve the issue, check these common pitfalls:

Simulate a Browser with Request Headers：Some services block requests that don't have a valid User-Agent header. Add a browser-like header to your Java request to avoid being flagged as a non-browser client:
```
connection.setRequestProperty("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
```
Validate Your API Key：Ensure your Google Cloud API key has the Static Maps API enabled, isn't over its quota, and doesn't have IP restrictions that block your Java application's server.
Check URL Encoding for Polyline Data：If your directional polyline contains special characters, use URLEncoder.encode() on the polyline parameter value before building the URL—don't just concatenate raw strings.
Verify SSL Certificate Trust：If your Java environment doesn't trust Google's SSL certificates, it might silently fail or return invalid content. Check your application logs for SSL-related exceptions.

3. Corrected Code Example

Here's a cleaned-up snippet incorporating the fixes above:

try {
    // Fixed URL with & instead of &amp;
    String mapImgUrl = "https://maps.googleapis.com/maps/api/staticmap?size=300x300&path=enc:YOUR_POLYLINE_HERE&key=YOUR_API_KEY";
    URL url = new URL(mapImgUrl);
    HttpURLConnection connection = (HttpURLConnection) url.openConnection();
    
    // Add browser-like User-Agent to avoid being blocked
    connection.setRequestProperty("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
    
    // Read and save the image
    InputStream inputStream = connection.getInputStream();
    FileOutputStream outputStream = new FileOutputStream("static_map.png");
    
    byte[] buffer = new byte[4096];
    int bytesRead;
    while ((bytesRead = inputStream.read(buffer)) != -1) {
        outputStream.write(buffer, 0, bytesRead);
    }
    
    // Clean up resources
    outputStream.close();
    inputStream.close();
    connection.disconnect();
} catch (IOException e) {
    e.printStackTrace();
}

内容的提问来源于stack exchange，提问作者jb2003