地理位置

如果您想指定从哪个地点访问一个特定的网站，请添加x-oxylabs-geo-location标头。
可用的地理位置值及其逻辑根据您选择的目标网站而不同。
谷歌
作为地理位置值，您可以使用几个选项：国家、州、城市或坐标， 以及半径。
使用一个国家名
要获得一个国家地理中心点的本地化结果，请传递一个国家名称。例如，如果您想访问一个网站的内容，就像从德国访问一样，则请添加"x-oxylabs-geo-location": "Germany"到您的标头。
可从下方下载所支持地理位置参数值的完整列表。
universal-supported-geo_location-values.csv
3KB
Text
代码示例
cURL
Python
PHP
C#
Golang
Java
Node.js
curl -k -v -x unblock.oxylabs.io:60000 \
-U USERNAME:PASSWORD "https://www.google.com/search?q=adidas" \
-H "x-oxylabs-geo-location:Germany"
import requests
​
# Define proxy dict. Don't forget to put your real user and pass here as well.
proxies = {
  'http': 'http://USERNAME:[email protected]:60000',
  'https': 'http://USERNAME:[email protected]:60000',
}
​
headers = {
    "x-oxylabs-geo-location": "Germany"
}
​
response = requests.get(
    'https://www.google.com/search?q=adidas',
    verify=False,  # It is required to ignore certificate
    proxies=proxies,
    headers=headers,
)
​
# Print result page to stdout
print(response.text)
​
# Save returned HTML to result.html file
with open('result.html', 'w') as f:
    f.write(response.text)
<?php
$ch = curl_init();
​
curl_setopt($ch, CURLOPT_URL, "https://www.google.com/search?q=adidas");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_PROXY, 'unblock.oxylabs.io:60000');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "YOUR_USERNAME" . ":" . "YOUR_PASSWORD");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
​
curl_setopt_array($ch, array(
    CURLOPT_HTTPHEADER  => array(
        'x-oxylabs-geo-location: Germany',
    )
));
​
$result = curl_exec($ch);
echo $result;
​
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
?>
using System;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
​
namespace OxyApi
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var webProxy = new WebProxy
            {
                Address = new Uri($"http://unblock.oxylabs.io:60000"),
                BypassProxyOnLocal = false,
                UseDefaultCredentials = false,
​
                Credentials = new NetworkCredential(
                userName: "YOUR_USERNAME",
                password: "YOUR_PASSWORD"
                )
            };
​
            var httpClientHandler = new HttpClientHandler
            {
                Proxy = webProxy,
            };
​
            // We recommend accepting our certificate instead of allowing insecure (http) traffic
            httpClientHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
            httpClientHandler.ServerCertificateCustomValidationCallback =
                (httpRequestMessage, cert, cetChain, policyErrors) =>
                {
                    return true;
                };
​
​
            var client = new HttpClient(handler: httpClientHandler, disposeHandler: true);
            
            // Add x-oxylabs-geo-location header
            client.DefaultRequestHeaders.Add("x-oxylabs-geo-location", "Germany");
            
            Uri baseUri = new Uri("https://www.google.com/search?q=adidas");
            client.BaseAddress = baseUri;
​
            var requestMessage = new HttpRequestMessage(HttpMethod.Get, "");
​
            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();
​
            Console.WriteLine(contents);
        }
    }
}
package main
​
import (
	"crypto/tls"
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)
​
func main() {
	const Username = "YOUR_USERNAME"
	const Password = "YOUR_PASSWORD"
​
	proxyUrl, _ := url.Parse(
		fmt.Sprintf(
			"http://%s:%[email protected]:60000",
			Username,
			Password,
		),
	)
	customTransport := &http.Transport{Proxy: http.ProxyURL(proxyUrl)}
​
	// We recommend accepting our certificate instead of allowing insecure (http) traffic
	customTransport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}
​
	client := &http.Client{Transport: customTransport}
	request, _ := http.NewRequest("GET",
		"https://www.google.com/search?q=adidas",
		nil,
	)
	
	// Add x-oxylabs-geo-location header
	request.Header.Add("x-oxylabs-geo-location", "Germany")
	
	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)
​
	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}
​
import okhttp3.Authenticator;
import okhttp3.Credentials;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import javax.net.ssl.*;
import java.net.InetSocketAddress;
import java.net.Proxy;
​
public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Proxy-Authorization";
    public static final String USERNAME = "YOUR_USERNAME";
    public static final String PASSWORD = "YOUR_PASSWORD";
​
    public void run() {
        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
​
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };
​
        OkHttpClient.Builder builder = new OkHttpClient.Builder();
​
        // We recommend accepting our certificate instead of allowing insecure (http) traffic
        this.disableSSLCertificateChecking(builder);
​
        Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("unblock.oxylabs.io", 60000));
        var client = builder
                .proxy(proxy)
                .proxyAuthenticator(authenticator)
                .build();
​
        var request = new Request.Builder()
                .url("https://www.google.com/search?q=adidas")
                .addHeader("x-oxylabs-geo-location", "Germany")
                .get()
                .build();
​
        try (var response = client.newCall(request).execute()) {
            assert response.body() != null;
            System.out.println(response.body().string());
        } catch (Exception exception) {
            exception.printStackTrace();
            System.exit(1);
        }
​
        System.exit(0);
    }
​
    private void disableSSLCertificateChecking(OkHttpClient.Builder builder) {
        TrustManager[] trustManagers = new TrustManager[]{
                new X509TrustManager() {
                    @Override
                    public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                        return new java.security.cert.X509Certificate[]{};
                    }
​
                    @Override
                    public void checkServerTrusted(java.security.cert.X509Certificate[] x509Certificates, String authType) {
                    }
​
                    @Override
                    public void checkClientTrusted(java.security.cert.X509Certificate[] x509Certificates, String authType) {
                    }
                }
        };
​
        try {
            HttpsURLConnection.setDefaultHostnameVerifier((s, sslSession) -> true);
            SSLContext sslContext = SSLContext.getInstance("TLS");
            sslContext.init(null, trustManagers, new java.security.SecureRandom());
            HttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFactory());
​
            builder.sslSocketFactory(sslContext.getSocketFactory(), (X509TrustManager) trustManagers[0]);
        } catch (Exception exception) {
            exception.printStackTrace();
            System.exit(1);
        }
​
        builder.hostnameVerifier((hostname, session) -> true);
    }
​
    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
import fetch from 'node-fetch';
import createHttpsProxyAgent from 'https-proxy-agent'
​
const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';
​
const agent = createHttpsProxyAgent(
  `http://${username}:${password}@unblock.oxylabs.io:60000`
);
​
// We recommend accepting our certificate instead of allowing insecure (http) traffic
process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;
​
const headers = {
  'x-oxylabs-geo-location': 'Germany',
}
​
const response = await fetch('https://www.google.com/search?q=adidas', {
  method: 'get',
  headers: headers,
  agent: agent,
});
​
console.log(await response.text());
使用一个州名
如需从一个特定的州访问一个网站，请传递一个 "State,Country"格式的x-oxylabs-geo-location值。它适用于美国、澳大利亚、印度和其他联邦制国家。例如："x-oxylabs-geo-location": "California,United States"。
cURL
Python
PHP
C#
Golang
Java
Node.js
curl -k -v -x unblock.oxylabs.io:60000 \
-U USERNAME:PASSWORD "https://www.google.com/search?q=adidas" \
-H "x-oxylabs-geo-locatio:California,United States"
import requests
​
# Define proxy dict. Don't forget to put your real user and pass here as well.
proxies = {
  'http': 'http://USERNAME:[email protected]:60000',
  'https': 'http://USERNAME:[email protected]:60000',
}
​
headers = {
    "x-oxylabs-geo-location": "California,United States"
}
​
response = requests.get(
    'https://www.google.com/search?q=adidas',
    verify=False,  # It is required to ignore certificate
    proxies=proxies,
    headers=headers,
)
​
# Print result page to stdout
print(response.text)
​
# Save returned HTML to result.html file
with open('result.html', 'w') as f:
    f.write(response.text)
<?php
$ch = curl_init();
​
curl_setopt($ch, CURLOPT_URL, "https://www.google.com/search?q=adidas");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_PROXY, 'unblock.oxylabs.io:60000');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "YOUR_USERNAME" . ":" . "YOUR_PASSWORD");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
​
curl_setopt_array($ch, array(
    CURLOPT_HTTPHEADER  => array(
        'x-oxylabs-geo-location: California,United States',
    )
));
​
$result = curl_exec($ch);
echo $result;
​
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
?>
using System;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
​
namespace OxyApi
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var webProxy = new WebProxy
            {
                Address = new Uri($"http://unblock.oxylabs.io:60000"),
                BypassProxyOnLocal = false,
                UseDefaultCredentials = false,
​
                Credentials = new NetworkCredential(
                userName: "YOUR_USERNAME",
                password: "YOUR_PASSWORD"
                )
            };
​
            var httpClientHandler = new HttpClientHandler
            {
                Proxy = webProxy,
            };
​
            // We recommend accepting our certificate instead of allowing insecure (http) traffic
            httpClientHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
            httpClientHandler.ServerCertificateCustomValidationCallback =
                (httpRequestMessage, cert, cetChain, policyErrors) =>
                {
                    return true;
                };
​
​
            var client = new HttpClient(handler: httpClientHandler, disposeHandler: true);
            
            // Add x-oxylabs-geo-location header
            client.DefaultRequestHeaders.Add("x-oxylabs-geo-location", "California,United States");
            
            Uri baseUri = new Uri("https://www.google.com/search?q=adidas");
            client.BaseAddress = baseUri;
​
            var requestMessage = new HttpRequestMessage(HttpMethod.Get, "");
​
            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();
​
            Console.WriteLine(contents);
        }
    }
}
package main
​
import (
	"crypto/tls"
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)
​
func main() {
	const Username = "YOUR_USERNAME"
	const Password = "YOUR_PASSWORD"
​
	proxyUrl, _ := url.Parse(
		fmt.Sprintf(
			"http://%s:%[email protected]:60000",
			Username,
			Password,
		),
	)
	customTransport := &http.Transport{Proxy: http.ProxyURL(proxyUrl)}
​
	// We recommend accepting our certificate instead of allowing insecure (http) traffic
	customTransport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}
​
	client := &http.Client{Transport: customTransport}
	request, _ := http.NewRequest("GET",
		"https://www.google.com/search?q=adidas",
		nil,
	)
	
	// Add x-oxylabs-geo-location header
	request.Header.Add("x-oxylabs-geo-location", "California,United States")
	
	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)
​
	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}
​
import okhttp3.Authenticator;
import okhttp3.Credentials;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import javax.net.ssl.*;
import java.net.InetSocketAddress;
import java.net.Proxy;
​
public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Proxy-Authorization";
    public static final String USERNAME = "YOUR_USERNAME";
    public static final String PASSWORD = "YOUR_PASSWORD";
​
    public void run() {
        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
​
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };
​
        OkHttpClient.Builder builder = new OkHttpClient.Builder();
​
        // We recommend accepting our certificate instead of allowing insecure (http) traffic
        this.disableSSLCertificateChecking(builder);
​
        Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("unblock.oxylabs.io", 60000));
        var client = builder
                .proxy(proxy)
                .proxyAuthenticator(authenticator)
                .build();
​
        var request = new Request.Builder()
                .url("https://www.google.com/search?q=adidas")
                .addHeader("x-oxylabs-geo-location", "California,United States")
                .get()
                .build();
​
        try (var response = client.newCall(request).execute()) {
            assert response.body() != null;
            System.out.println(response.body().string());
        } catch (Exception exception) {
            exception.printStackTrace();
            System.exit(1);
        }
​
        System.exit(0);
    }
​
    private void disableSSLCertificateChecking(OkHttpClient.Builder builder) {
        TrustManager[] trustManagers = new TrustManager[]{
                new X509TrustManager() {
                    @Override
                    public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                        return new java.security.cert.X509Certificate[]{};
                    }
​
                    @Override
                    public void checkServerTrusted(java.security.cert.X509Certificate[] x509Certificates, String authType) {
                    }
​
                    @Override
                    public void checkClientTrusted(java.security.cert.X509Certificate[] x509Certificates, String authType) {
                    }
                }
        };
​
        try {
            HttpsURLConnection.setDefaultHostnameVerifier((s, sslSession) -> true);
            SSLContext sslContext = SSLContext.getInstance("TLS");
            sslContext.init(null, trustManagers, new java.security.SecureRandom());
            HttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFactory());
​
            builder.sslSocketFactory(sslContext.getSocketFactory(), (X509TrustManager) trustManagers[0]);
        } catch (Exception exception) {
            exception.printStackTrace();
            System.exit(1);
        }
​
        builder.hostnameVerifier((hostname, session) -> true);
    }
​
    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
import fetch from 'node-fetch';
import createHttpsProxyAgent from 'https-proxy-agent'
​
const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';
​
const agent = createHttpsProxyAgent(
  `http://${username}:${password}@unblock.oxylabs.io:60000`
);
​
// We recommend accepting our certificate instead of allowing insecure (http) traffic
process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;
​
const headers = {
  'x-oxylabs-geo-location': 'California,United States',
}
​
const response = await fetch('https://www.google.com/search?q=adidas', {
  method: 'get',
  headers: headers,
  agent: agent,
});
​
console.log(await response.text());
使用一个城市名
如果您想得到针对某个特定城市的本地化结果，请将此处的CSV中的一个数值以"City,State,Country"格式传递给我们。 例如，如果您想访问一个网站的内容，如同从纽约访问，则请添加"x-oxylabs-geo-location": "New York,New York,United States"。
cURL
Python
PHP
C#
Golang
Java
Node.js
curl -k -v -x unblock.oxylabs.io:60000 \
-U USERNAME:PASSWORD "https://www.google.com/search?q=adidas" \
-H "x-oxylabs-geo-location:New York,New York,United States"
import requests
​
# Define proxy dict. Don't forget to put your real user and pass here as well.
proxies = {
  'http': 'http://USERNAME:[email protected]:60000',
  'https': 'http://USERNAME:[email protected]:60000',
}
​
headers = {
    "x-oxylabs-geo-location": "New York,New York,United States"
}
​
response = requests.get(
    'https://www.google.com/search?q=adidas',
    verify=False,  # It is required to ignore certificate
    proxies=proxies,
    headers=headers,
)
​
# Print result page to stdout
print(response.text)
​
# Save returned HTML to result.html file
with open('result.html', 'w') as f:
    f.write(response.text)
<?php
$ch = curl_init();
​
curl_setopt($ch, CURLOPT_URL, "https://www.google.com/search?q=adidas");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_PROXY, 'unblock.oxylabs.io:60000');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "YOUR_USERNAME" . ":" . "YOUR_PASSWORD");
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
​
curl_setopt_array($ch, array(
    CURLOPT_HTTPHEADER  => array(
        'x-oxylabs-geo-location: New York,New York,United States',
    )
));
​
$result = curl_exec($ch);
echo $result;
​
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
?>
using System;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
​
namespace OxyApi
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var webProxy = new WebProxy
            {
                Address = new Uri($"http://unblock.oxylabs.io:60000"),
                BypassProxyOnLocal = false,
                UseDefaultCredentials = false,
​
                Credentials = new NetworkCredential(
                userName: "YOUR_USERNAME",
                password: "YOUR_PASSWORD"
                )
            };
​
            var httpClientHandler = new HttpClientHandler
            {
                Proxy = webProxy,
            };
​
            // We recommend accepting our certificate instead of allowing insecure (http) traffic
            httpClientHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
            httpClientHandler.ServerCertificateCustomValidationCallback =
                (httpRequestMessage, cert, cetChain, policyErrors) =>
                {
                    return true;
                };
​
​
            var client = new HttpClient(handler: httpClientHandler, disposeHandler: true);
            
            // Add x-oxylabs-geo-location header
            client.DefaultRequestHeaders.Add("x-oxylabs-geo-location", "New York,New York,United States");
            
            Uri baseUri = new Uri("https://www.google.com/search?q=adidas");
            client.BaseAddress = baseUri;
​
            var requestMessage = new HttpRequestMessage(HttpMethod.Get, "");
​
            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();
​
            Console.WriteLine(contents);
        }
    }
}
package main
​
import (
	"crypto/tls"
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)
​
func main() {
	const Username = "YOUR_USERNAME"
	const Password = "YOUR_PASSWORD"
​
	proxyUrl, _ := url.Parse(
		fmt.Sprintf(
			"http://%s:%[email protected]:60000",
			Username,
			Password,
		),
	)
	customTransport := &http.Transport{Proxy: http.ProxyURL(proxyUrl)}
​
	// We recommend accepting our certificate instead of allowing insecure (http) traffic
	customTransport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}
​
	client := &http.Client{Transport: customTransport}
	request, _ := http.NewRequest("GET",
		"https://www.google.com/search?q=adidas",
		nil,
	)
	
	// Add x-oxylabs-geo-location header
	request.Header.Add("x-oxylabs-geo-location", "New York,New York,United States")
	
	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)
​
	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}
​
import okhttp3.Authenticator;
import okhttp3.Credentials;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import javax.net.ssl.*;
import java.net.InetSocketAddress;
import java.net.Proxy;
​
public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Proxy-Authorization";
    public static final String USERNAME = "YOUR_USERNAME";
    public static final String PASSWORD = "YOUR_PASSWORD";
​
    public void run() {
        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
​
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };
​
        OkHttpClient.Builder builder = new OkHttpClient.Builder();
​
        // We recommend accepting our certificate instead of allowing insecure (http) traffic
        this.disableSSLCertificateChecking(builder);
​
        Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("unblock.oxylabs.io", 60000));
        var client = builder
                .proxy(proxy)
                .proxyAuthenticator(authenticator)
                .build();
​
        var request = new Request.Builder()
                .url("https://www.google.com/search?q=adidas")
                .addHeader("x-oxylabs-geo-location", "New York,New York,United States")
                .get()
                .build();
​
        try (var response = client.newCall(request).execute()) {
            assert response.body() != null;
            System.out.println(response.body().string());
        } catch (Exception exception) {
            exception.printStackTrace();
            System.exit(1);
        }
​
        System.exit(0);
    }
​
    private void disableSSLCertificateChecking(OkHttpClient.Builder builder) {
        TrustManager[] trustManagers = new TrustManager[]{
                new X509TrustManager() {
                    @Override
                    public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                        return new java.security.cert.X509Certificate[]{};
                    }
​
                    @Override
                    public void checkServerTrusted