本地搜索
Google 本地搜索 API 检索餐厅、酒店和服务的基于位置的结果并提供过滤选项。
该 google_maps 该 source 旨在检索 Google 本地搜索结果。它抓取各种基于位置的数据，例如餐馆、酒店、咖啡店、加油站、杂货店等。
请求示例
在此示例中，我们发出请求以检索前 3 页的酒店可用性，适用于 1 位客人之间 2023-10-01 和 2023-10-10 用于 巴黎的酒店 出发 google.com.sons.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "google_maps",
"domain": "com",
"pages": 3,
"query": "hotels in Paris",
"context": [
{
"key": "hotel_occupancy",
"value": 1
},
{
"key": "hotel_dates",
"value": "2023-10-01,2023-10-10"
}
]
}'import requests
from pprint import pprint
# 构建负载（payload）。
payload = {
'source': 'google_maps',
'domain': 'com',
'query': 'hotels in Paris',
'pages': 3,
'context': [
{'key': 'hotel_occupancy', 'value': 1},
{'key': 'hotel_dates', 'value': '2023-10-01,2023-10-10'},
],
}
# 获取响应。
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# 将美化后的响应打印到标准输出。
pprint(response.json())const https = require("https");
const username = "USERNAME";
const password = "PASSWORD";
const body = {
source: "google_maps",
domain: "com",
pages: 3,
query: "hotels in Paris",
context: [
{ key: "hotel_occupancy", value: 1 },
{ key: "hotel_dates", value: "2023-10-01,2023-10-10" },
],
};
const options = {
hostname: "realtime.oxylabs.io",
path: "/v1/queries",
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization:
"Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
},
};
const request = https.request(options, (response) => {
let data = "";
response.on("data", (chunk) => {
data += chunk;
});
response.on("end", () => {
const responseData = JSON.parse(data);
console.log(JSON.stringify(responseData, null, 2));
});
});
request.on("error", (error) => {
console.error("Error:", error);
});
request.write(JSON.stringify(body));
request.end();https://realtime.oxylabs.io/v1/queries?source=google_maps&domain=com&query=hotels+in+Paris&pages=3&context[0][key]=hotel_occupancy&context[0][value]=1&context[1][key]=hotel_dates&context[1][value]=2023-10-01,2023-10-10&access_token=12345abcde<?php
$params = array(
'source' => 'google_maps',
'domain' => 'com',
'query' => 'hotels in Paris',
'pages' => 3,
'context' => [
['key' => 'hotel_occupancy', 'value' => 1],
['key' => 'hotel_dates', 'value' => '2023-10-01,2023-10-10']
]
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");
$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$result = curl_exec($ch);
echo $result;
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
}
curl_close($ch);package main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
const Username = "USERNAME"
const Password = "PASSWORD"
payload := map[string]interface{}{
"source": "google_maps",
"domain": "com",
"pages": 3,
"query": "hotels in Paris",
"context": []map[string]interface{}{
{"key": "hotel_occupancy", "value": 1},
{"key": "hotel_dates", "value": "2023-10-01,2023-10-10"},
},
}
jsonValue, _ := json.Marshal(payload)
client := &http.Client{}
request, _ := http.NewRequest("POST",
"https://realtime.oxylabs.io/v1/queries",
bytes.NewBuffer(jsonValue),
)
request.SetBasicAuth(Username, Password)
response, _ := client.Do(request)
responseText, _ := ioutil.ReadAll(response.Body)
fmt.Println(string(responseText))
}using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;
namespace OxyApi
{
class Program
{
static async Task Main()
{
const string Username = "USERNAME";
const string Password = "PASSWORD";
var parameters = new {
source = "google_maps",
domain = "com",
pages = 3,
query = "hotels in Paris",
context = new dynamic [] {
new { key = "hotel_occupancy", value = 1 },
new { key = "hotel_dates", value = "2023-10-01,2023-10-10" }
}
};
var client = new HttpClient();
Uri baseUri = new Uri("https://realtime.oxylabs.io");
client.BaseAddress = baseUri;
var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
requestMessage.Content = JsonContent.Create(parameters);
var authenticationString = $"{Username}:{Password}";
var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);
var response = await client.SendAsync(requestMessage);
var contents = await response.Content.ReadAsStringAsync();
Console.WriteLine(contents);
}
}
}package org.example;
import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;
public class Main implements Runnable {
private static final String AUTHORIZATION_HEADER = "Authorization";
public static final String USERNAME = "USERNAME";
public static final String PASSWORD = "PASSWORD";
public void run() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("source", "google_maps");
jsonObject.put("domain", "com");
jsonObject.put("pages", 3);
jsonObject.put("query", "hotels in Paris");
jsonObject.put("context", new JSONArray()
.put(new JSONObject()
.put("key", "hotel_occupancy")
.put("value", 1))
.put(new JSONObject()
.put("key", "hotel_dates")
.put("value", "2023-10-01,2023-10-10"))
);
Authenticator authenticator = (route, response) -> {
String credential = Credentials.basic(USERNAME, PASSWORD);
return response
.request()
.newBuilder()
.header(AUTHORIZATION_HEADER, credential)
.build();
};
var client = new OkHttpClient.Builder()
.authenticator(authenticator)
.readTimeout(180, TimeUnit.SECONDS)
.build();
var mediaType = MediaType.parse("application/json; charset=utf-8");
var body = RequestBody.create(jsonObject.toString(), mediaType);
var request = new Request.Builder()
.url("https://realtime.oxylabs.io/v1/queries")
.post(body)
.build();
try (var response = client.newCall(request).execute()) {
if (response.body() != null) {
try (var responseBody = response.body()) {
System.out.println(responseBody.string());
}
}
} catch (Exception exception) {
System.out.println("Error: " + exception.getMessage());
}
System.exit(0);
}
public static void main(String[] args) {
new Thread(new Main()).start();
}
}{
"source": "google_maps",
"domain": "com",
"pages": 3,
"query": "hotels in Paris",
"context": [
{
"key": "hotel_occupancy",
"value": 1
},
{
"key": "hotel_dates",
"value": "2023-10-01,2023-10-10"
}
]
}在我们的示例中，我们使用同步的 Realtime 集成方法。如果您想使用 Proxy Endpoint 或异步的 Push-Pull 集成，请参阅 集成方法 部分。
请求参数值
通用
抓取 Google 本地搜索结果的基本设置和自定义选项。
- 必填参数
本地化
将搜索结果适配到特定的地理位置、域和语言。
分页
用于管理分页和检索搜索结果的控制项。
参数
说明
默认值
start_page
起始页码。
1
pages
要检索的页数。
1
limit
每页要检索的结果数量。
10
其他
用于专门需求的附加高级设置和控制。
参数
说明
默认值
context:
nfpr
true 将关闭拼写自动更正
false
context:
hotel_occupancy
客人数。 注意： 仅当您搜索与酒店相关的搜索词时，此参数才适用。
-
context:
hotel_dates
在酒店入住的时长，从 - 至。示例： 2023-07-12,2023-07-13
注意： 仅当您搜索与酒店相关的搜索词时，此参数才适用。
上下文参数
所有上下文参数应作为对象添加到 context 数组中，包含 key 和 value 键值对，例如：
...
"context": [
{
"key": "filter",
"value": "0"
}
]
...输出示例
{
"results": [
{
"content":"<!doctype html>\n<html lang=\"en\">\n<head>
...
</script></body>\n</html>\n",
"created_at": "2024-02-13 11:44:28",
"updated_at": "2024-02-13 11:45:06",
"page": 3,
"url": "https://www.google.com/search?tbm=lcl&q=hotels+in+Paris&hotel_occupancy=1&hotel_dates=2023-10-01,2023-10-10&start=40&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
"job_id": "7163135836748268545",
"status_code": 200
}
]
}
最后更新于
这有帮助吗？